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AVANT-PROPOS 



Les technologies 
du Flash dynamique 



Aujourd'hui, Flash s'est impose dans l'univers d'Internet comme un standard pour la creation et la 
publication de contenu multimedia en ligne. Desormais, plus de 98 % des navigateurs sont equipes 
du plug-in Flash, ce qui rend ses animations utilisables - sans telechargement prealable - par tous les 
internautes, et devrait convaincre les derniers concepteurs encore reticents a utiliser Flash dans leurs 
creations. 

Cependant, les exigences des realisateurs d' animations Flash ne se limitent plus a la composition 
d'interfaces sonorisees et au graphisme elabore. Leurs creations doivent maintenant permettre de 
mettre en ceuvre des applications Web dynamiques a la fois puissantes et esthetiques. La solution qui 
repond pleinement a ces nouvelles attentes est le « Flash dynamique », car il permet de creer des 
applications associant la souplesse d'un client leger a la puissance des technologies serveur couplees 
avec une base de donnees. 

En effet, avec les dernieres avancees du langage ActionScript 2.0, Flash est desormais en mesure de 
prendre en charge des traitements algorithmiques complexes. Toutefois, meme si FActionScript 2.0 
est encore plus rapide et performant que les versions precedentes, la creation d'une animation Flash 
dynamique necessite toujours l'intervention d'un second langage de programmation cote serveur, 
arm d'assurer la liaison avec une base de donnees. 

Dans le cadre de cet ouvrage, nous utiliserons le couple PHP-MySQL qui est desormais Fune des 
technologies serveur les plus utilisees dans les applications Web dynamiques. De plus, PHP dispose 
d'un nombre important de bibliotheques de fonctions qui viendront completer les scripts de FAS 2.0 
tout en permettant d'equilibrer la charge entre le poste client et le serveur pour obtenir une application 
encore plus performante. 

Nous pounions difficilement presenter le Flash dynamique sans consacrer une partie au XML. En 
effet, grace a ses nombreuses fonctions qui permettent de traiter nativement un fichier XML, Flash 
peut desormais echanger tres facilement ses donnees avec tout type de technologie. De meme, si la 
structure des informations d'un fichier XML lui permet de se substituer a l'usage d'une base de 
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donnees, en Flash dynamique elle sera surtout exploitee pour acheminer les informations issues 
d'une base de donnees vers F animation Flash, tout en conservant sa structure initiale. 

Enfin, nous nous interesserons aussi a la solution alternative AMFPHP, qui permet de mettre en 
ceuvre rapidement un systeme de communication entre le client Flash et des applications serveur 
PHP. 

Ainsi, l'usage conjoint de ces differentes technologies permet d'elaborer des applications Flash 
dynamiques a la fois dotees d'une interface client esthetique et sonore, mais aussi de ressources 
serveur puissantes, capables de sauvegarder des donnees complexes ou encore de gerer tout type 
d' informations en temps reel. 

Objectifs de I'ouvrage 

Le contenu de ce volume a ete pense de facon a repondre aux attentes des concepteurs Web desirant 
creer des applications Flash dynamiques a l'aide des technologies ActionScript 2.0, PHP, MySQL 
et XML. Aucun prerequis en programmation ni en base de donnees n'est necessaire, mais une 
experience dans la creation d' animations Flash est souhaitable. 

Louvrage est divise en de plusieurs parties abordant progressivement les differentes techniques de 
programmation depuis la syntaxe d'un langage jusqu'a la programmation objet. 

Dans chacune de ces parties, un chapitre d' introduction vous permettra de decouvrir les concepts de 
base. II est suivi de deux autres chapitres traitant de la mise en ceuvre de ces techniques en Action- 
Script et en PHP. L etude parallele des deux langages facilitera ainsi le transfert de connaissances ou 
d'experiences prealables d'une technologie a l'autre. 

Deux autres parties sont consacrees aux bases de donnees et aux structures XML afin de mettre rapide- 
ment en pratique l'utilisation conjointe de ces differentes technologies pour realiser des applications 
Flash dynamiques. 

Nous vous presenterons aussi les differents types d'interfacages possibles entre une application 
cliente Flash et des ressources serveur TXT, PHP, MySQL ou XML. Ces interfacages pourront etre 
ensuite tres facilement adaptes a vos futurs projets, vous permettant ainsi d'ameliorer la productivite 
de vos creations. 

A la fin de cet ouvrage, nous verrons en detail comment installer et exploiter les classes AMFPHP. 
Cette technique de communication entre Flash et le serveur n'est pas la seule solution alternative aux 
interfacages presentes dans cet ouvrage, mais elle presente l'avantage d'etre developpee en Open 
Source et d' exploiter la technologie serveur PHP. 

Etudes de cas 

Afin d'illustrer le fonctionnement des differentes techniques presentees, chaque partie se termine par 
diverses etudes de cas pratiques : 

• un annuaire (Flash + TXT) (chapitre 11); 

• un repertoire (Flash + PHP) (chapitre 11); 
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• un compteur de visite Flash (Flash + PHP + TXT) (chapitre 1 1) ; 

• un back-office d' administration d'une base de donnees (PHP + MySQL) (chapitre 18) ; 

• un controle d'acces dynamique (Flash + PHP + MySQL) (chapitre 18) ; 

• un menu deroulant XML (Flash + XML) (chapitre 22) ; 

• une visionneuse de diapos (Flash + PHP + XML) (chapitre 22) ; 

• un systeme de signets dynamiques (Flash + XML + PHP + MySQL) (chapitre 22) ; 

• un systeme de discussion en ligne - Chat (Flash + XML + socket PHP) (chapitre 22). 



1 



Flash 8 

et les sites dynamiques 



Dans ce premier chapitre, nous allons rappeler le fonctionnement des sites statiques pour mieux 
comprendre celui des sites dynamiques et plus particulierement celui des applications Flash dynami- 
ques. Nous vous presenterons aussi, en guise d'exemple, quelques applications Web dynamiques a la 
fois puissantes et esthetiques exploitant le couple Flash-PHP. 

Du HTML au Flash dynamique 

Les sites statiques et le HTML 
Le langage HTML 

Avant de presenter les langages utilises pour la conception de sites dynamiques, rappelons quelques 
notions de base sur les pages Web statiques. Nous appelons « page Web » toute page pouvant etre 
affichee dans un navigateur (Internet Explorer, Netscape...). Le langage utilise pour la conception 
d'une page Web est le Hyper Text Markup Language. II ne s'agit pas d'un langage de programmation 
au sens propre, mais d'un langage de description d'une page Web. Le fichier qui contient la descrip- 
tion de cette page porte en general l'extension .htm ou .html. II est constitue du texte et des liens aux 
images a afficher, repartis entre des balises (par exemple : <p>...</p>) qui determinent la facon dont 
ces elements seront presentes dans le navigateur. Certaines de ces balises permettent egalement de 
transformer un texte ou une image en lien hypertexte (<a>...</a>). Ces hyperliens (les liens hypertextes) 
sont tres importants dans une page Web, puisqu'ils permettent d'organiser la navigation dans un site 
en reliant les pages entre elles. Les internautes peuvent passer d'une page a l'autre grace a un simple 
clic sur ces liens, d'ou l'expression « naviguer » ou « surfer » sur le Web (voir figures 1-1 et 1-2). 
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Figure 1-1 

Exemple de code HTML d'une page Web 



-3 Page Html - Microsoft Internet Explorer 
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Html, un langage statique : 

Avant de presenter les langages utilises pour la conception de 
sites dynamiques, rappelons quelques notions de base sur les 
pages web statiques. 
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Figure 1-2 

Interpretation et affichage du code de la figure 1-1 dans un navigateur Internet : le navigateur recoit le code 
HTML de la page et I'affiche a Vecran en interpretant les dijferentes balises qu 'il contient. 
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Vous pouvez ainsi mettre en forme votre texte et disposer les images a votre convenance dans la page 
en les reliant entre elles par des liens hypertextes. Cependant, vous ne disposez d'aucune instruction 
pour realiser un traitement different en fonction d'un evenement ou d'une condition particuliere. 
C'est pourquoi une page HTML est dite « statique » : elle s'affiche toujours sous la meme forme et 
toutes les pages susceptibles d'etre appelees doivent etre stockees sur le serveur (voir figure 1-3). 



Figure 1-3 

Arborescence d'un site statique : 
toutes les pages du site doivent etre 
presentes sur le serveur. 



£2> pagesStatiques 
d pagel.htm 
d page2.htm 
d page3.htm 
® page4.htm 

d index.htm 



Nous verrons plus loin que d'autres langages, comme PHP {Personal Home Page, devenu par la suite 
Hypertext Preprocessor), permettent de creer des pages « dynamiques » qui peuvent etre personnalisees 
selon une requete ou le profil de Finternaute. lis utilisent pour cela un seul et meme fichier modele, 
en interaction avec une base de donnees. 

Larchitecture client-serveur 

Nous venons de voir que les sites statiques sont constitues d'un ensemble de pages HTML reliees 
entre elles par des liens hypertextes qui permettent de naviguer de l'une a F autre. Le protocole utilise 
pour transferer des informations sur Internet s'appelle HTTP {Hyper Text Transfer Protocol). Une 
requete HTTP (par exemple : http://www.eyrolles.com/page.htm) est envoyee vers le serveur afin 
d'acceder a la page desiree et de la visualiser dans le navigateur du poste client (voir etape 1 de la 
figure 1-4). 



3 Interpretation du code Html par le navigateur client 




Figure 1-4 

L' architecture client-serveur : le poste client envoie au serveur une requete HTTP ; le serveur Web recherche 
puisfournit au poste client la page demandee, qui est ensuite interpretee par le navigateur. 
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Lorsque le serveur Web recoit cette requete, il recherche la page demandee paimi toutes les pages 
HTML presentes sur le site concerne et la renvoie ensuite au client (voir etape 2 de la figure 1-4). Le 
code HTML recu par le poste client est alors interprete et affiche par le navigateur (voir etape 3 de la 
figure 1-4). C'est ce qu'on appelle l'architecture client-serveur (je demande, on me sert) : le client est 
le navigateur Internet (Internet Explorer, Netscape...) et le serveur est le serveur Web sur lequel est 
stocke le site Internet. 

Ce type de site est tres simple a realiser et on peut s'en contenter dans le cadre de petits projets de 
quelques dizaines de pages et dont la mise a jour n'est pas frequente. Cependant, il affiche vite ses 
limites pour la conception d' applications plus consequentes ou necessitant de frequentes mises a jour. 
Les sites marchands et autres portails d'informations ne peuvent pas etre realises sur ce modele. 

Le code HTML est un langage interprete et non compile comme le sont les differents programmes 
dedies a un type d'ordinateur specifique (PC, Mac...). Pour illustrer ce qu'est un programme 
compile, prenons le cas de votre editeur de texte (Word, par exemple). Lorsque vous l'avez achete, 
vous avez du preciser si vous aviez un PC ou un Mac, car il a ete compile differemment selon le type 
d'ordinateur auquel il est destine. Ce programme ne peut fonctionner que sur la plate-forme pour 
laquelle il a ete compile. Ce n'est pas le cas des langages interpreted, qui ont un code commun a tous 
les types d'ordinateurs. La raison de cette polyvalence est que le code source est interprete du cote 
client par le logiciel adapte a la machine (voir figure 1-5). Ce genre de langage est done bien adapte 
a Internet ou le pare d'ordinateurs est tres heterogene. On peut ainsi envoyer le meme code HTML 
a tous les navigateurs des internautes, quel que soit leur ordinateur. En revanche, cela oblige le 
serveur a envoyer tout le code source sur le poste client, laissant a quiconque la possibility de le 



Le serveur envoie le meme code source Html quelque soit le type d'ordinateur du client 




POSTE CLIENT 



PC 

Figure 1-5 

L' interpretation du code HTML cote client permet d' envoyer le meme code quel que soit le type d'ordinateur de 
I'internaute. Chaque navigateur etant adapte a la plate-forme sur laquelle il est installs, il interprete le code 
HTML en Vadaptant aux particularites de V ordinateur du client. 
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copier et de Futiliser comme bon lui semble. Cet inconvenient n'est pas negligeable car, dans ces 
conditions, il devient difficile de proteger son code source et la confidentialite des informations 
qu'il pourrait contenir. 

Nous verrons plus loin que le langage PHP n'herite pas de ce defaut, car son code source est pre- 
interprete et transforme en equivalent HTML cote serveur ; seul le code HTML ainsi produit est 
envoye au client, ce qui preserve les sources PHP et leur contenu. 

Les sites interactifs et les langages de script 

Heureusement, revolution des techniques Internet permet desormais de developper des pages inte- 
ractives beaucoup plus interessantes et attractives pour l'internaute. 

Pour creer de l'interactivite sur un site, le concepteur multimedia dispose de plusieurs technologies 
qui peuvent etre executees cote client (JavaScript dans une simple page HTML ou ActionScript dans 
une animation Flash) ou cote serveur (PHP, ASP, JSP, CFML, etc.)- Le choix du type de technologie 
depend de 1' application a mettre en ceuvre, de son niveau de securite, de la qualite de son interface et 
de sa rapidite d'execution. 

Interactivity cote client avec JavaScript 



JavaScript 

JavaScript (a ne pas confondre avec Java) est un langage tres largement employe sur Internet cote client, meme 
s'il peut aussi fonctionner cote serveur. II a ete mis au point par Netscape Communications. Ses instructions sont 
incluses dans le code HTML des pages envoyees sur le poste client et sont traitees directement par le navigateur. 



La solution la plus simple pour creer de l'interactivite consiste a integrer quelques lignes de code Java- 
Script dans une page HTML. Lorsqu'une requete HTTP appelle la page HTML (voir etape 1 de la 
figure 1-6), le serveur Web laretourne au poste client afin qu'elle puisse etre interpretee comme une page 
HTML classique (voir etapes 2 et 3 de la figure 1-6). Le script inclus dans la page est ensuite traite par le 
navigateur des que Fevenement pour lequel il a ete programme survient (voir etape 4 de la figure 1-6). 



4 Execution d'un script cote client 

3 Interpretation du code HTML par le navigateur 




Figure 1-6 

Utilisation d'un script cote client avec JavaScript : il existe une dependance relative au navigateur client mais 
l'interactivite est rapide. 
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Les scripts cote client sont tres reactifs car le script s'execute directement sur le poste client. En 
revanche, les programmes JavaScript peuvent se comporter differemment selon le type d'ordinateur 
et la version du navigateur. Par exemple, un script en JavaScript peut parfaitement fonctionner sur 
Firefox mais poser des problemes avec Internet Explorer ou creer des erreurs sous IE 5 alors qu'il 
fonctionne sous IE 6. De meme, les resultats peuvent varier selon qu'on utilise un PC ou un Mac. 
Tout cela impose au concepteur multimedia de realiser des tests importants s'il desire que sa page 
interactive fonctionne sur toutes les plates-formes et dans toutes les configurations. 

Interactivity cote client avec ActionScript 

Une autre solution pour mettre en ceuvre de r inter activite cote client consiste a creer une animation 
Flash dans laquelle sera integre un programme ActionScript. Le script etant present sur le poste 
client, l'application est aussi reactive qu'avec le JavaScript, mais la qualite de 1' interface et son esthe- 
tique expliquent l'engouement toujours croissant des developpeurs pour cette solution. 

Cependant, meme si le plug-in Flash est present par defaut sur plus de 98 % des navigateurs actuels 
(source site Macromedia), sa version peut ne pas etre compatible avec celle de votre animation Flash. 
II faudra verifier ce parametre a l'aide d'un detecteur de version (en utilisant le Dispatcher de Macro- 
media, par exemple) afin d'aiguiller le visiteur vers Fespace de telechargement du plug-in si sa 
version n'est pas adaptee a votre animation. 



(3) Interpretation de I'animation par le Plug-ing Flash 




Figure 1-7 

Utilisation d'une animation Flash avec ActionScript : Vinteractivite est aussi rapide qu'avec JavaScript 
cote client, mais V interface est plus esthetique. 

Interactivity cote serveur avec PHP 

L'interactivite peut etre placee cote serveur. Dans ce cas, le serveur Web doit disposer d'un prepro- 
cesseur PHP afin de traiter les scripts PHP integres dans la page avant de l'envoyer au poste client qui 
en a fait la demande (voir etapes 1 et 2 de la figure 1-8). 

Si on le compare avec un script cote client, la reaction a un evenement d'un script cote serveur est 
beaucoup plus lente car elle necessite l'envoi d'une requete au serveur (voir figure 1-8, etape 1), son 
execution sur le serveur (etape 2), le retour de la reponse par le reseau Internet (etape 3) et le chargement 
de la page dans le navigateur (etape 4). 
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En revanche, les langages cote serveur sont independants de la plate-forme du client ou de la version 
de son navigateur. En effet, 1' interpretation du script est realisee cote serveur et le code envoye vers 
1' ordinate ur du client est compatible avec le standard HTML et done interprete de la meme maniere 
par tous. 



A noter 

Parmi les inconvenients des scripts cote serveur, il faut signaler que leur utilisation necessite la disponibilite d'un 
serveur adapte. Meme si les offres des hebergeurs qui proposent des serveurs integrant des scripts dynamiques 
sont de plus en plus accessibles, il faut en tenir compte lors de votre choix. 



4 Interpretation du code HTML par le navigateur 



2 Execution d'un script c6te serveur 




SERVEUR WEB 



Figure 1-8 

Utilisation d'un script cote serveur : il n 'y pas de dependance vis-a-vis du navigateur client mais I 'interactivity 
est plus lente. 



Les sites dynamiques et ies bases de donnees 
Creation de modeles dynamiques 

L' execution du script cote serveur permet de creer une page « a la volee » lors de son execution par le 
preprocesseur PHP integre au serveur. La page ainsi creee contient les mimes informations qu'une 
simple page HTML. Elle peut done etre interpretee sans probleme par le navigateur cote client (voir 
figure 1-9). Lors de la creation de cette page, les scripts integres au fichier dynamique sont executes 
et, si necessaire, etablissent une connexion a un serveur de donnees. Avec ce processus, la page dyna- 
mique devient un modele de presentation des informations. Ce modele est personnalise par des 
contenus differents selon la requete du client. 

II n'est done plus necessaire, par exemple, de creer une page specifique pour presenter chaque 
produit d'un catalogue : une seule page dynamique peut etre utilisee. II suffit de lui indiquer l'identi- 
fiant du produit demande grace a une variable qui lui est transmise en meme temps que son appel ; la 
page renvoyee au client contient toutes les informations et photos relatives au produit concerne. 
Larborescence du site est simplifiee puisque cette page dynamique remplace les nombreuses pages 
statiques correspondant a chaque produit (voir figure 1-10). 
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<?php include("requeteBase.php") ? 

<HTML> 

<HEAD> <title>Page\)yn amique</title > </HEAD> 



<font s/ze="7"x?php echo $titre ?></font> 
</p> 

<px?php echo $descriptif ?></p> 






SI des informations doivent 
etre recuperees d'une base 
de donnees, une requete 
serveur permettra de les 
integrer dans la page 



\ 



La page dynamique peut 
etre personnalisee selon 
differentes variables 
affichees a I'ecran. 



<pximg src= "<?php echo $photo ?>.jpg" ></p> 



Les images ou les liens 
hypertextes pourront 
aussi etre geres 
dynamiquement. 



<P> / 
<a href="page.php?id=l">pagei </a> 
<a href = "page. php?id=2">page2</a> 

</p> 

</BODY> 
</HTML> 

Figure 1-9 

Exemple de code d'une page dynamique produisant le meme ajfichage que la page de la figure 1-2 



Eh© pagesDynamiques 
page.php 
index, php 

Figure 1-10 

L'arborescence d'un site dynamique contient beaucoup moins de fichiers que celle d'un site statique : 
lesfichiers dynamiques faisant office de modeles, il suffit de leur envoyer une variable dijferente pour 
qu 'ils se personnalisent a la demande. 



Pourquoi utiliser une base de donnees ? 

Nous venons d'expliquer que l'utilisation des scripts cree de l'interactivite dans un site. En effet, ils 
permettent d'integrer dans une page des instructions conditionnelles pour realiser des traitements 
differents en fonction de Fetat des variables testees. Les pages creees par ces scripts sont elaborees 
avec des informations contextuelles fournies par l'internaute lui-meme ou issues d'un traitement 
realise a partir de celles-ci. Ces informations sont exploitables uniquement le temps de la session 
active et ne peuvent pas etre memorisees d'une session a 1' autre, ce qui limite considerablement les 
applications utilisant uniquement des scripts serveur. Une premiere solution pour conserver ces infor- 
mations consiste a les enregistrer dans de petits fichiers (cookies) cote client, arm de recuperer le 
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profil de l'internaute lors de sa prochaine visite. Cependant, de nombreux internautes interdisent 
l'enregistrement d' informations sur leur ordinateur. Une deuxieme solution s'appuie sur l'enregistre- 
ment de ces informations dans des fichiers de donnees, mais du cote serveur cette fois. Dans ce cas, 
la disponibilite de ces fichiers n'est plus tributaire du bon vouloir de l'internaute, mais cette solution 
manque de souplesse dans F exploitation des informations et son organisation devient vite ingerable 
pour des sites consequents. La troisieme solution est d'utiliser une base de donnees dans laquelle on 
stocke toutes les informations utiles aux applications du site. Le script cote serveur contient alors les 
procedures de connexion a la base de donnees et des instructions specifiques pour lire, ajouter, modi- 
fier, creer ou lister des enregistrements. Meme si cette solution necessite la presence d'une base de 
donnees et le developpement de scripts de gestion de ses enregistrements, c'est de loin la plus effi- 
cace et la plus souple dans une grande majorite d' applications. Elle est actuellement employee sur la 
plupart des sites professionals definis comme dynamiques. Les sites dynamiques sont done caracte- 
rises par le fait qu'ils fonctionnent avec des scripts cote serveur et qu'ils exploitent les informations 
issues d'une base de donnees. 

Pour pouvoir exploiter une base de donnees, le systeme doit etre organise selon une architecture a 
trois niveaux (dite architecture trois tiers) mettant en relation le client, le serveur Web et la base de 
donnees. Meme si la base de donnees est souvent installee sur le meme ordinateur que le serveur 
Web, ce modele est valable dans la plupart des cas (voir figure 1-11 et figure 1-12). 

Applications dynamiques avec PHP-MySQL 

Les etapes de traitement d'un site dynamique classique (sans animation Flash) sont les suivantes : 

1 . Le poste client envoie une requete HTTP sur un fichier comportant un script PHP (voir etape 1 de 
la figure 1-11). 

2. Le serveur Web localise le fichier dynamique et l'execute (voir etape 2 de la figure 1-11). 



Recuperation des donnees demandees dans la base 3 
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la page Html par 
le navlgateur 



Insertion des donnees recuperee de la base 4 
dans la page creee par le script 



2 Execution du 
script cote 
serveur 
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SERVEUR WEB 



Figure 1-11 

Fonctionnement d'un site dynamique classique PHP -MySQL 
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3. Si le script necessite des informations issues de la base de donnees, il adresse une requete SQL au 
serveur de la base de donnees MySQL qui lui renvoie les informations demandees (voir etape 3 
de la figure 1-11). 

4. Les informations issues de la base de donnees sont ensuite integrees dans la page dynamique 
(voir etape 4 de la figure 1-11). 

5. La page ainsi creee est ensuite envoyee au client et interpreted comme une simple page HTML 
par le navigateur (voir etapes 5 et 6 de la figure 1-11). 

Applications dynamiques avec PHP-MySQL et Flash 

Avec un site dynamique classique, le serveur Web envoie au navigateur une page HTML entiere 
generee a la volee par le preprocesseur PHP. Le fonctionnement est different dans le cas d'une 
animation Flash dynamique. En effet, la premiere etape consiste a charger 1' animation Flash dans le 
navigateur (voir etapes 1, 2 et 3 de la figure 1-12) comme nous l'avons explique dans la partie 
consacree a l'interactivite cote client avec ActionScript (revoir figure 1-7). Ensuite, lorsqu'un 
evenement necessitant une information dynamique survient (voir etape 4 de la figure 1-12), une 
requete est envoyee directement par 1' animation Flash au serveur Web (voir etape 5 de la figure 1- 
12). Cette requete cible cette fois un script PHP specifique (voir etape 6 de la figure 1-12) qui, 
contrairement a celui d'un site dynamique classique, ne genere pas une page HTML dynamique- 
ment mais cree et renvoie a 1' animation Flash une structure de donnees au format couple variable- 
valeur ou, mieux encore, au format XML (voir etapes 7, 8, 9 et 10 de la figure 1-12). Cette structure 
de donnees est ensuite receptionnee puis traitee par 1' animation Flash qui exploite les informations 
recues comme de simples variables internes. 



Recuperation des donnees demandees dans la base 8 

Insertion des donnees recuperees de la base 
dans la structure de donnees renvoyees 9 
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Figure 1-12 

Fonctionnement d'un site dynamique PHP-MySQL couple avec une application client Flash 
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Evolution de PHP : de I'origine a PHP 5 

Nous vous proposons maintenant de rappeler brievement les etapes qui ont marque revolution de 
PHP, de I'origine jusqu'au PHP 5 actuel. 

PHP-FI 

Lors de sa creation, la particularite de la technologie serveur PHP etait de pouvoir gerer les formulaires, 
d'ou 1' appellation de sa premiere version PHP-FI, FI signifiant Forms Interpreter. Peu de temps apres 
sa creation, Rasmus Lerdof decida d'ouvrir son code a la communaute Internet, ce qui contribua a 
son evolution rapide. 

PHP 2 

Ainsi, des 1997, il existait deja plus de 50 000 sites utilisant le PHP, ce qui represente a peu pres 1 % 
des domaines de l'epoque. La premiere grande evolution de PHP est la version PHP 2, qui vit le jour 
en 1997. Cette version, assez ephemere, a ete surtout diffusee en version beta et fut rapidement 
remplacee par la version 3. 

PHP 3 

La version 2 de PHP affichant des performances insuffisantes qui bloquaient son evolution, et notam- 
ment son exploitation dans le domaine du e-commerce, la nouvelle version 3 de PHP a ete complete- 
ment reecrite. Diffusee en 1998, PHP 3.0 fut reellement la premiere version fonctionnelle et stable de 
PHP. Elle se distinguait principalement par la possibilite d'ajouter des extensions (bibliotheques de 
programmes complementaires et dedies a un usage precis). Cela permit a PHP de s'enrichir des 
nombreuses extensions que Ton connait aujourd'hui et qui sont a I'origine de son succes. 

PHP 4 

En 2000, juste avant le lancement de la nouvelle version 4, PHP 3 etait deja installe sur plus de 10 % 
des sites Internet. PHP 4.0 se distinguait par des performances encore plus elevees (son moteur ayant 
ete restructure completement) et par une nouvelle gestion des variables HTTP qui permettait notam- 
ment une utilisation plus facile des sessions. Notons a ce sujet que, a partir de la version 4.1, la 
syntaxe des variables HTTP a ete simphnee ($_GET[] au lieu de $HTTP_GET_VARS[], par exemple) et 
que la configuration par defaut du fichier d'initialisation PHP a ete modifiee a partir de la version 4.2 afin 
d'augmenter la securite, mais nous aurons l'occasion d'en reparler au cours des prochains chapitres. 

PHP 5 

La premiere version stable de PHP 5.0 a ete diffusee en 2004. Cette nouvelle version avait pour 
objectif de rendre PHP plus professionnel tout en conservant sa simplicite de developpement, qui est 
a I'origine de son succes. PHP 5 permet done de mieux rivaliser avec les differentes technologies 
alternatives (ASP, ASP.net, JSP, CFML...). Parmi ses nouveautes, citons l'apparition du nouveau 
moteur Zend Engine 2, lequel permet une programmation completement orientee objet (POO), 
l'integration en interne de la base de donnees SQLite (mais nous n'aborderons pas SQLite dans cet 
ouvrage) et une nouvelle prise en charge des flux XML. 
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Compatibility entre les versions 5 et 4 de PHP 

Hormis la programmation orientee objet et quelques fonctions mineures dont la syntaxe a change, tous Ies exem- 
ples et Ies applications presentes dans cet ouvrage pourront etre exploites sur PHP 4 comme sur PHP 5. 



Exemples d'applications Flash dynamiques 

Si la conception d'une application Flash dynamique est un peu plus compliquee que celle d'une 
simple animation Flash et demande l'apprentissage de nouveaux langages (ActionScript, PHP, SQL, 
XML), les avantages qui en decoulent compensent largement votre investissement initial. Voici quel- 
ques exemples qui devraient vous en convaincre. 

Mises a jour automatisees 

Des que votre application commence a prendre de l'embonpoint, les mises a jour des contenus 
textuels deviennent longues et fastidieuses. En utilisant un langage de programmation cote serveur, 
vous pouvez automatiser totalement ou partiellement ces mises a jour. En effet, si les informations 
affichees dans votre animation sont issues d'une base de donnees, il vous suffit de preparer vos diffe- 
rentes mises a jour en indiquant la date a partir de laquelle elles doivent apparaitre sur le site. Vous 
pouvez ainsi programmer plusieurs semaines a l'avance les actualisations ou promotions que vous 
desirez voir apparaitre sur le site. 

Une maintenance assistee 

En construisant judicieusement votre animation et en centralisant ses parametres de configuration 
dans une base de donnees (ou dans un fichier XML), vous pouvez tres facilement modifier la presen- 
tation des differents ecrans de 1' animation en n'intervenant que sur les parametres du fichier de confi- 
guration. Dans le cas d'un site mixte integrant une version HTML et une version completement 
Flash, vous pouvez modifier de la meme maniere la configuration des deux versions simultanement 
grace a des parametres de configuration communs qui pourront ensuite etre lus aussi facilement 
depuis les pages PHP ou a partir de 1' animation Flash. 

Sites muitiiangues 

Si vous desirez creer une animation en plusieurs langues, il vous suffit de prevoir des zones de texte 
dynamiques liees a une base de donnees. Ces champs seront renseignes par le texte correspondant a 
la langue choisie par l'internaute. En outre, avec ce systeme, Fajout d'une langue supplementaire ne 
requiert que l'insertion d'un nouveau champ dans la base de donnees et ne necessite pas d'interven- 
tion dans les zones d'affichage. 
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19. Algo : Les tableaux (ou listes) 

20. Algo : Les structures condltionnelles (Les tests avec lf()) 

21. Algo : Les structures condltionnelles (Les tests avec switch 
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Figure 1-13 

Le site www. 1 expl i cateur. com est dedie aux developpeurs d' animation Flash, Un champ de recherche permet 
de saisir un mot-cle pour rechercher rapidement le petit morceau de code ActionScript qui vous manque. 
Ce site est structure autour d'une interface Flash couplee avec une base de donnees MySQL. 



Recherche multicritere 

Sur Internet, tous les outils de recherche utilisent des technologies dynamiques pour creer « a la 
volee » les pages de resultats correspondant aux requetes des internautes. Certains de ces outils ajou- 
tent a la puissance de leur serveur une interface graphique Flash qui permet de presenter ces resultats 
sous forme de cartes interactives et animees (voir figure 1-14). 
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Figure 1-14 

Le site www. kartoo. com est un metamoteur de recherche qui presente ses resultats sous forme de carte. 11 exploite 
judicieusement la puissance de ses scripts serveur et de sa base de donnees, associes a une interface client en Flash 
qui affiche les resultats sous forme de cartes interactives et animees. 



Diffusions d 'information en temps reel 

La qualite graphique d'une interface Flash, couplee avec la puissance d'une base de donnees, permet de 
realiser des applications animees pour diffuser des medias en temps reel (resultats sportifs, cotations 
boursieres, resultats d'elections. . .). Pour ce type de site, les informations sont generalement centralisees 
par des journalistes dans une base de donnees en ligne. Les animations Flash des postes client inter- 
rogent cette base de donnees pour recuperer F information, qui sera affichee dans F interface client en 
temps reel (voir figures 1-15 et 1-16). 
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Figure 1-15 

L'affichage des resultats des dernieres elections presidentielles utilisait une carte de France Flash 
couplee avec une base de donnees MySQL en ligne. Lors des depouillements, les journalistes mettaient 
a jour la base de donnees afin que les animations Flash des pastes client puissent actualiser en temps reel 
les resultats affiches dans leur interface. 



Reporting industriel ou financier 

Le Flash dynamique permet d'elaborer en temps reel des tableaux de bord ergonomiques pour visua- 
liser revolution de Factivite economique d'un reseau commercial (ventes, stocks...). II suffit pour 
cela que les responsables de chaque agence saisissent periodiquement leurs chiffres dans une base de 
donnees en ligne. Lors de la premiere consultation, les tableaux de bord seront automatiquement 
actualises. 
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Figure 1-16 

Grace ait Flash dynamique, les residtats des rencontres de football et les evenements qui out ponctue 
les matchs peuvent etre diffuses en temps reel. De plus, les photos numeriques du match peuvent etre 
visualisees des qu'elles sont telechargees sur le serveur. 



Interfaces client personnalisees 

Si votre site est dote d'une interface Flash dynamique, vous pouvez proposer a vos visiteurs de definir 
leurpropre interface personnalisee. Apres que le visiteur a configure F interface, chaque parametre est 
memorise dans une base de donnees. II suffit de recuperer ces informations lors de son prochain 
passage pour personnaliser de nouveau son interface dynamiquement. 



Carte d 'information dynamique 

Si vous desirez mettre a jour en ligne les coordonnees des distributeurs d'un reseau commercial et definir 
dynamiquement la situation de l'agence sur une carte, creez une interface Flash dynamique couplee 
avec quelques scripts PHP et une base de donnees MySQL. Les visiteurs de votre site disposeront 
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instantanement des informations a partir d'une carte dynamique qui affiche les nouvelles coordonnees 
lors d'un simple survol de la zone concernee. 

Jeux en ligne 

En general, les fonctions Action Script suffisent pour creer des jeux Flash mono-utilisateur. Cepen- 
dant, si vous desirez memoriser les meilleurs scores ou creer des jeux multi-utilisateurs, il est alors 
necessaire de faire appel au Flash dynamique (voir figure 1-17). 

mTmni i B^y»nf' i iwjiii; l KiViiii ; iii4Mii 1 | if l 'ji | iii i ,viJii--itt 
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Figure 1-17 

Parmi les nombreux jeux developpes en Flash, certains exploitent aussi la technologie PHP-MySQL comme 
I'illustre le jeu du « Defi » du site globulos.com. Dans ce jeu, les dijferents parametres d'un defi propose par un 
premier joueur sont memorises dans une base de donnees MySQL puis recuperes a I'aide d'une requete SQL 
afin d'etre exploites par le second joueur desirant relever le defi. 

Boutiques de produits en ligne 

Si vous desirez doter votre boutique de produits en ligne d'une interface graphique attractive tout en 
conservant la souplesse de la gestion centralisee des produits dans une base de donnees, le Flash 
dynamique est la technologie qu'il vous faut. 
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Choix de I' infrastructure serveur 

Contrairement a un site statique, un site dynamique doit disposer d'une infrastructure serveur. En 
effet, comme nous Favons indique dans le chapitre precedent, plusieurs applications sont necessaires 
a son fonctionnement cote serveur : 

• un serveur Web (le serveur Apache est le plus frequemment utilise) ; 

• un langage de script serveur (dans cet ouvrage, nous utiliserons PHP) ; 

• un serveur de base de donnees (dans cet ouvrage, nous utiliserons MySQL). 

Selon les ressources materielles dont vous disposez, plusieurs solutions peuvent etre exploiters. 

La premiere solution concerne les developpeurs, qui disposent d'une connexion permanente et rapide 
a Internet et d'un serveur Web distant equipe d'une base de donnees MySQL et d'un moteur de 
scripts PHP (voir figure 2-1). 

La deuxieme solution est la plus exigeante. Elle concerne surtout les societes de developpement 
Internet qui ont a leur disposition un serveur Web en local, avec PHP et MySQL, en plus de leur 
serveur distant de production (voir figure 2-2). 

La troisieme solution est accessible a tous, puisqu'il suffit d'installer sur son poste de developpement 
une infrastructure serveur avec PHP et MySQL qui emule en local le meme comportement que le 
serveur Web distant (voir figure 2-3). 

Nous avons retenu la troisieme solution pour realiser toutes les demonstrations de cet ouvrage. 
Cependant, les concepts developpes sont identiques quelle que soit la methode retenue. 
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Figure 2-1 

Infrastructure serveur utilisant le ser\>eur distant pour les evaluations dynamiques 
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SERVEUR WEB DE DEVELOPPEMENT 



-Publication en FTP sur serveur distant^ 
INTERNET 




Figure 2-2 

Infrastructure serveur utilisant un sen : eur du reseau local pour les evaluations dynamiques 
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SERVEUR WEB DE PRODUCTION 



Figure 2-3 

Infrastructure serveur utilisant un serveur local integre dans le poste de developpement (WebLocal de Wamp 5, 
par exemple) pour les evaluations dynamiques 



Afin de vous accompagner dans la mise en ceuvre de votre plate-forme de developpement, le paragra- 
phe suivant sera consacre a l'installation d'une infrastructure serveur locale. 



Publication en FTP et evaluation en HTTP 

Internet permet de relier de nombreux ordinateurs distants par un support physique. Cependant, pour que ces 
derniers puissent dialoguer, ils doivent utiliser un meme protocole. Le principal protocole d'lnternet est le HTTP 
(Hypertext Transfer Protocol) qui permet aux internautes de consulter (ou d'evaluer, dans notre cas) des pages 
Web a I'aide de leur navigateur, mais il existe d'autres protocoles dedies a des medias specifiques ou permettant 
d'acceder a des services en ligne. Ainsi, les protocoles SMTP et POP3 permettent de gerer les e-mails, ou encore 
le protocole FTP (File Transfer Protocol} qui permet le transfert (ou la publication, dans notre cas) de fichiers d'un 
ordinateur a I'autre. 



Etapes d 'installation de la suite Wamp 5 

Vous pouvez telecharger gratuitement la derniere version de Wamp 5 sur le site www.wampserver.com. 
Copiez le fichier wamp5_l . 6 . 0 . exe (ou une version plus recente) sur votre ordinateur et lancez l'instal- 
lation en double-cliquant sur le fichier. Une premiere fenetre apparait (voir figure 2-4), vous recom- 
mandant de fermer toutes les applications actives avant de lancer F installation. Cliquez ensuite sur 
Next pour faire apparaitre les conditions d'utilisation (licence) qu'il faut valider. Dans l'ecran suivant, 
vous pouvez choisir le repertoire dans lequel vous allez installer le logiciel. Nous vous suggerons de 
valider l'option par defaut (C: \wamp, voir figure 2-5). Dans l'ecran qui suit, choisissez le dossier de 
programme dans lequel le logiciel apparaitra (nous vous recommandons de choisir celui suggere par 
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Figure 2-4 

Installation de Wamp 5 : ecran de bienvenue affiche au debut de V installation 




Figure 2-5 

Installation de Wamp 5 : choix du repertoire d' installation 
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Ready to Install 

Setup is now ready to begin installing WAMP5 on your computet. 




Click Instal to continue with the installation, or click Back if you want to review or 
change any settings. 



Destination location: 
c:\wamp 



Start Menu folder: 
WampServer 




Ld 



< Back 




Cancel 



Figure 2-6 

Installation de Wamp 5 : apres avoir choisi le repertoire d' installation et le nom du dossier 

qui sera cree dans le menu Programme de Windows, vous pouvez lancer V installation en cliquant 

sur le bouton Install. 

Wamp, soit WampServer). L'ecran suivant vous permet de demarrer automatiquement Wamp 5 lors de 
la mise en marche de votre ordinateur. Si vous cochez cette case, le logiciel se lancera automatique- 
ment a chaque demarrage ; sinon, il vous faudra penser a lancer Wamp 5 depuis le menu Tous les 
programmes de Windows avant chaque utilisation. L'ecran suivant vous signale que tout est pret pour 
demarrer Finstallation ; il suffit alors de cliquer sur Instal 1 (voir figure 2-6). Pendant F installation, 
le logiciel vous indique sa progression. Finalement, il affiche un ecran qui vous propose de choisir le 
repertoire dans lequel seront stockees les pages dynamiques PHP. Choisissez le repertoire www 
propose par defaut et cliquez sur le bouton OK. 

L'ecran suivant vous invite a choisir le navigateur a utiliser par defaut (dans notre cas nous avons 
choisi explorer.exe, qui est le navigateur propose par defaut). Enfin, un dernier ecran indique que 
Finstallation de Wamp s'est correctement deroulee et vous propose de demarrer le logiciel (case 
precochee). 

Apres validation du dernier ecran, Wamp 5 demarre automatiquement et une icone apparait dans la 
barre des taches de votre ordinateur (voir figure 2-7). II existe trois etats possibles de cette icone. Si 
cette icone (en forme de demi-cercle) est completement blanche, cela signifie que les deux serveurs 
(le serveur Apache et MySQL) sont en ordre de marche. Si les deux premiers tiers du demi-cercle 
sont jaunes, cela signifie qu'au moins un des deux serveurs est arrete (ou pas encore demarre). Enfin, 
si le premier tiers du demi-cercle est rouge, cela signifie que les deux serveurs sont a F arret. 
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Figure 2-7 

Installation de Wamp 5: des le 
demurrage du logiciel, une icone 
apparait dans la barre des tdches. 
Si vous cliquez sur cette icone, 
le manager de Wamp 5 apparait 
d son tour. 




Arret et demarrage de Wamp 5 

Avant d'utiliser Wamp 5, il est utile de rappeler la procedure de gestion des serveurs et du logiciel 
pour vos futures utilisations. Pour commencer, je vous invite a arreter les serveurs de Wamp 5. Pour 
cela, cliquez sur l'icone de Wamp 5, puis dans le menu contextuel qui s'affiche (par la suite nous 
appellerons ce menu contextuel le manager de Wamp 5). Cliquez ensuite sur Stop All Services. 
L'icone doit alors changer d'etat et apparaitre avec son premier tiers rouge. Pour redemarrer les 
serveurs de Wamp 5 vous devez parcourir le manager de Wamp 5 et selectionnez cette fois l'option 
Start All Services. Notez que si l'icone de Wamp 5 passe au jaune ou au rouge, cela indique que vos 
serveurs (ou l'un de vos serveurs) ne sont plus operationnels. II faudra alors acceder au manager et 
selectionner l'option Restart All Services pour reactiver le (ou les) serveur de Wamp 5. 

Nous venons de voir la procedure permettant de gerer 1' arret et le redemarrage des serveurs de Wamp 5 ; 
cependant, si vous desirez arreter completement 1' application, vous devrez effectuer un clic droit sur 



Figure 2-8 

Redemarrage de Wamp 5 : 
si les serveurs sont arretes, il suffit 
de cliquer sur I 'icone de Wamp 5 
puis de selectionner l'option Start All 
Services pour les redemarrer. 




Infrastructure serveur PHP-MySQL 

Chapitre 2 



la meme icone et selectionner Exit (l'icone doit alors disparaitre completement de la baiTe des 
taches). Pour relancer le logiciel Wamp 5, deroulez le menu Programmes du bouton Demarrer de 
Windows, puis le dossier WampServer et cliquez sur l'icone Start wampserver. La meme demarche 
devra d'ailleurs etre effectuee lors du demarrage de votre ordinateur avant chaque utilisation des 
fonctionnalites dynamiques de Dreamweaver (sauf si vous avez coche la case de demarrage automa- 
tique dans la procedure d' installation que nous venons de detailler). 



Decouverte du manager de Wamp 5 

Le manager de Wamp 5 vous permet d'acceder aux fonctions ci-dessous (les differentes options 
seront detaillees commencant par le haut du manager) : 

Locahost - donne acces au Web local et permet de tester toutes les pages enregistrees sous la racine 
www (soit http: //local host/, qui correspond a la racine situee a l'emplacement C:/wamp/www/). 

PhpMy Admin - permet d'acceder au gestionnaire de base de donnees MySQL nomme phpMy Ad- 
min (soit l'alias http: //local host/phpmyadmin/, voir figure 2-9). 
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Figure 2-9 

La rubrique phpMyAdmin du manager Wamp 5 vous permet d'acceder au gestionnaire phpMyAdmin de la base 
de donnees MySQL. 
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3 SQLiteManager Microsoft Internet Explorer 




Figure 2-10 

La rubrique SQLiteManager du manager Wamp 5 vous permet d 'acceder ait gestionnaire SQLiteManager de la 
base de donnees SQLite integree a PHP. 



SQLiteManager - permet d' acceder au gestionnaire de base de donnees integre a PHP nomme 
SQLite (soitl'alias http://localhost/sqlitemanager7, voir figure 2-10). 

www directory - donne acces a un explorateur Windows configure pour s'ouvrir automatiquement 
dans le repertoire racine www (C : \wamp\www\, voir figure 2-11) 

Log f i 1 es - permet d' afficher les fichiers de log du serveur Apache {apache error log), du preproces- 
seur PHP (php error log) et du serveur MySQL (mysql error log). Ces fichiers de log pourront etre 
avantageusement consultes pour identifier un probleme dans l'une des applications citees. 

Config files - ouvre dans le Bloc-notes les differents fichiers de configuration de la suite Wamp 5, a 
savoir : httpd.conf pour la configuration d' Apache, php . i ni pour la configuration de PHP et my.ini 
pour la configuration de MySQL. Vous pouvez ainsi consulter, voire modifier (a ne faire evidemment 
que si vous etes sur de vous . . .), les options de chaque fichier de configuration de la suite Wamp 5. 

PHP extensions - permet d'activer ou de desactiver une extension PHP (voir figure 2-12). Les exten- 
sions de PHP sont des bibliotheques de fonctions dediees a un usage particulier, qu'il faut activer sur 
le serveur avant d'etre en mesure de les exploiter dans vos programmes PHP. Certaines de ces exten- 
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Figure 2-11 

La rubrique www directory du manager Wamp 5 vous permet d'acceder a un explorateur Windows configure 
pour s' ouvrir automatiquement sur le repertoire C:\wamp\www\ 
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C SITEdemo.conf 



Bloc notes 




Figure 2-13 

Exemple d'une configuration d'alias sur un repertoire situe a I 'emplacement D:\www\SITEdemo\ 



sions sont activees par defaut (gestion des bases de donnees MySQL ou SQLite, ...) alors que 
d'autres doivent etre activees manuellement avant leur utilisation (gestion des fichiers PDF ou encore 
des fichiers XSL, ...)■ Pour activer une extension, il suffit de double-cliquer sur F extension desiree 
dans la liste proposee par le manager. 

Alias directories - permet de creer des repertoires alias pointant vers des ressources placees dans un 
emplacement different de la racine www (C : /wamp/www/ par defaut). Par exemple, si vous desirez creer 
un alias pointant sur des fichiers PHP places dans le repertoire D:/www/SITEdemo, il suffit de creer un 
alias /SITEdemo/ configure comme indique dans la figure 2-13. Ainsi, si vous appelez l'URL http : // 
local host/SITEdemo/ dans votre navigateur, vous accederez aux fichiers situes dans le repertoire D:/ 
www/SITEdemo et non a ceux du repertoire C:/wamp/www/SITEdemo/ qui n'existe pas en realite. 

Apache - donne acces a un sous-menu d' administration du serveur Apache. Vous pourrez ainsi arre- 
ter le serveur (Stop Service) et le redemarrer (Restart Service). Ce sous-menu vous permet aussi de 
desinstaller puis d' installer un autre serveur Apache d'une version differente. 

MySQL - donne acces a un sous-menu d' administration du serveur MySQL. Vous pourrez ainsi 
arreter le serveur (Stop Service) et le redemarrer (Restart Service). Ce sous-menu vous permet aussi 
de desinstaller puis d' installer un autre serveur MySQL d'une version differente. 

Start All Service - permet de demarrer tous les services en meme temps (Apache et MySQL). 

Stop All Service - permet d' arreter tous les services en meme temps (Apache et MySQL). 

Restart All Service - permet de redemarrer tous les services en meme temps (Apache et MySQL). 
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D'une version a I'autre 

Selon la version de Wamp 5 et de votre systeme d'exploitation, les ecrans et les procedures detailles precedem- 
ment peuvent etre tres legerement differents. A titre d'exemple, nous avons utilise la version 1 .6 de Wamp 5 pour 
nos demonstrations ; si vous utilisez une version anterieure, le manager sera organise differemment. II n'en 
demeure pas moins que le fonctionnement de ces logiciels reste identique d'une version a I'autre et que vous 
n'aurez pas de difficulty a adapter les procedures detaillees dans cet ouvrage. 



Test du serveur local 

Pour tester le bon fonctionnement du serveur Web et du moteur PHP, nous allons commencer par 
creer un script PHP a l'aide d'un simple editeur de texte. Ouvrez le Bloc-notes (notepad) de Windows 
a partir du menu Demarrer (Programmes>Accessoires>Bloc-notes) ou Simple Texte si vous utilisez 
un Macintosh. Saisissez ensuite les trois lignes de code suivantes dans Fediteur : 

< ?php 

echo "Bonjour, PHP fonctionne" ; 
?> 

Enregistrez ensuite ce fichier dans C:\wamp\www\SITEflash sous le nom bonjour. php, en prenant soin 
de selectionner le type Tous fichiers et en ajoutant au nom du fichier l'extension .php. Le repertoire 
SITEflash sera cree sous www lors de l'enregistrement (voir figure 2-14). Ce meme repertoire sera 
utilise dans les chapitres suivants pour tester certaines interactions entre des fichiers AS et des fichiers 
PHP, c'est pourquoi nous vous conseillons d'utiliser les merries conventions de nommage. De retour 
dans le Bloc-notes, assurez-vous que le nom du fichier apparait bien dans la barre de titre de la fenetre 
(voir - figure 2-15) puis fermez le Bloc-notes. 



[nregislrer sous ["?~| X 




Figure 2-14 

Enregistrez votre premier script sous le nom bonjour.php en vous assurant que le type de fichier selectionne 
est bien Tous fichiers. 
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?> 





Figure 2-15 

Apres son enregistrement, la barre de titre du Bloc-notes doit afficher bonjour.php. 



Ne jamais supprimer le fichier index.php de la racine www 

Lorsque vous acceder au localhost par le manager de Wamp 5, la page Web local qui s'affiche n'est autre que le 
fichier i ndex . php qui se trouve a la racine www. Si vous tenez a conserver cette page affichant les differents reper- 
toires de vos sites, il faudra veiller a ne pas supprimer ce fichier. Enfin, d'un point de vue organisationnel, nous vous 
conseillons de creer un repertoire different sur cette meme racine a chaque fois que vous ajouterez un nouveau site 
sur votre serveur local. Vous pourrez ainsi acceder a vos differents sites tres facilement depuis la page du Web local. 



Ouvrez maintenant la page Web local a paitir du manager de Wamp 5 (option Localhost du manager). 
Le repertoire SITEflash doit apparaitre en bas de cette page dans une rubrique nominee Vos projets 
(voir figure 2-16). Cliquez sur le lien SITEflash pour ouvrir une fenetre qui dresse la liste de tous les 




Figure 2-16 

La page Web local permet d 'acceder au repertoire SITEflash. 
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fichiers contenus dans ce repertoire : dans le cas present, nous retrouvons uniquement notre fichier 
bonjour.php (voir figure 2-17). 
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Figure 2-17 

Dans le repertoire SITEflash, nous retrouvons le flchier bonjour.php precedemment cree. 

Si vous cliquez maintenant sur le fichier bonjour.php, vous envoyez une requete au serveur Apache 
pour ouvrir le fichier dans le navigateur. Si le serveur Web et le moteur PHP fonctionnent correcte- 
ment, le message « Bonjour, PHP fonctionne » doit s'afficher dans le navigateur (voir figure 2-18). II 
est d'ailleurs interessant d'observer le code source envoye au navigateur en cliquant sur Source dans 
le menu Affichage (voir figure 2-19). On remarque que le code ne comporte plus les balises PHP ni 
l'instruction echo saisies lors de la creation du fichier (revoir figure 2-15), mais uniquement le 
message affiche dans le navigateur. En effet, lors de Fappel du fichier, celui-ci est d'abord execute par 
le moteur PHP du serveur Apache et e'est la page resultante qui est ensuite envoyee au navigateur 
pour son interpretation finale (revoir le concept des sites dynamiques au chapitre 1). 
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Figure 2-18 

Lors de Vappel du fichier bonjour.php, le message d'accueil doit s'afficher dans le navigateur si le serveur 
fonctionne correctement. 
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Figure 2-19 

En observant le code source dufichier interprets parle navigateur, on remarque qu 'il ne comporte plus aucune 
trace d' instructions PHP. 



Configuration du fichier php.ini 

Le fichier php.ini est le fichier qui permet de configurer de nombreux parametres et options d'execution de PHP. 
Ce fichier est lu a chaque demarrage du serveur Apache ; il suffit done de redemarrer le serveur Apache pour que 
les nouvelles options soient prises en compte. Pour vos premiers tests, nous vous conseillons de I'utiliser avec ses 
options par defaut mais, par la suite, vous pourrez facilement le modifier a I'aide du manager de Wamp 5. Pour 
acceder a ce fichier, il suffit de cliquer sur I'option Config files du manager de Wamp 5 puis de selectionner 
php . i ni . Une fois ce fichier ouvert dans le Bloc-notes, vous decouvrirez un grand nombre de parametres accom- 
pagnes de nombreux commentaires qui vous guideront dans leur configuration. Nous avons choisi de vous presen- 
ter trois de ces parametres, dont il conviendra de verifier la configuration : 

magic_quote_gpc : s'il est initialise avec la valeur On, ce parametre permet de prefixer automatiquement par une 
barre oblique inverse (\) les apostrophes, les guillemets et le caractere nul d'un texte envoye par un formulaire 
ou issu d'un cookie avant de I'enregistrer dans la base MySQL. II permet d'eviter d'avoir a utiliser les fonctions 
addSlashes() et stripSlashesQ a chaque insertion. Cette option est cependant maintenant deconseillee car elle 
necessite de mettre en place une gestion differente des donnees selon leur origine et entrame une legere baisse 
des performances du systeme. Vous pouvez toutefois I'activer pour assurer la compatibility avec d'anciens scripts. 
register_globals : s'il est initialise avec la valeur On, ce parametre permet d'utiliser les variables globales (varia- 
bles simples comme $varl) lors d'un passage d'une variable d'une page a I'autre (GET) ou de la recuperation de 
la valeur d'un champ de formulaire (GET ou POST). Cette option est configuree par defaut a Off depuis la version 4.2 
de PHP, ce qui contraint a utiliser les tableaux des variables serveur ($_P0ST[ 'varl'], $_GET[ 'varl ']...). Vous 
pouvez configurer ce parametre a On si vous utilisez des anciens scripts et que vous ne souhaitez pas les modifier. 
Cependant, nous vous conseillons vivement de laisser sa valeur a Off si vous developpez de nouveaux scripts, 
afin qu'ils soient exploitables quelle que soit la version de PHP utilisee. 

error_reporting : cette option peut etre parametree selon le niveau de controle de vos scripts desire. Dans les 
dernieres versions de PHP, cette option est configuree par defaut avec la valeur E_ALL qui est le niveau maximal 
de controle. Avec ce parametrage, toutes les variables non initialisees provoqueront automatiquement un warning 
(Undefined variable). Si vous desirez eviter ces frequents warning, vous pouvez remplacer la valeur actuelle 
par E_ALL & ~ E_N0TICE mais I'ideal est bien sur de programmer proprement et d'initialiser toutes les variables 
avant de les utiliser. 
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Gestion des extensions PHP 

Extensions installees par defaut 

Les extensions PHP sont des bibliotheques de fonctions dediees a une utilisation specifique. II existe 
ainsi des extensions dediees a MySQL, aux sessions ou encore au transfert FTP. 

Lorsque lors F installation de Wamp 5, certaines extensions PHP ont ete installees par defaut et sont 
done immediatement disponibles. 

Installation d'une extension 

L' installation d'une extension sur Wamp 5 est tres simple. Depuis le manager de Wamp 5, selection- 
nez PHP extensions puis recherchez l'extension a installer dans la liste. Si le nom de l'extension n'est 
pas precede d'une petite fleche, cela signifie que l'extension n'est pas encore installee. Cliquez alors 
sur son nom pour l'activer. Redemarrez ensuite Wamp 5 en cliquant sur Restart All services depuis le 
manager. Vous pouvez ensuite afficher de nouveau cette liste d' extensions afin de vous assurer que 
l'extension qui vient d'etre installee est maintenant precedee d'une petite fleche. 

Si vous etes sur un serveur distant, sachez qu'il est possible de verifier la presence d'une extension en 
affichant le fichier phpinfo.php et en recherchant 1' entree correspondant a l'extension dans les 
tableaux de cette page. A noter que sur Wamp 5, un fichier phpi nfo est directement disponible depuis 
la page localhost, accessible depuis F entree du meme nom dans le manager. 



Figure 2-20 

Pour installer une extension, 
affichez la liste des extensions 
a partir de I 'entree PHP extension 
du manager, puis cliquez 
sur V extension a installer. 




Gestionnaire phpMyAdmin 

La suite Wamp 5 comprend aussi une base de donnees MySQL ainsi que son gestionnaire phpMyAdmin. 
Pour acceder au gestionnaire phpMyAdmin et administrer la base de donnees, cliquez sur F entree du 
meme nom dans le menu du manager (voir figure 2-21). 
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Figure 2-21 

Poi<r acceder au gestionnaire de la base de donnees MySQL, ilfaut cliquer sur V entree phpMyAdmin du menu 
du manager de Wamp 5. 



L' interface du gestionnaire phpMyAdmin s'affiche alors dans le navigate ur (voir figure 2-21). Les 
differentes fonctionnalites de ce gestionnaire seront presentees en detail dans le chapitre 16. 
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Presentation de I'interface 

Ce chapitre presente les differentes fonctionnalites de I'interface dediees a la programmation 
ActionScript. Les concepts de base de I'interface Flash et les fonctionnalites utilisees pour creer de 
simples animations ne seront done pas abordes. Nous vous invitons a consulter un ouvrage d' initiation a 
Flash 8 si vous ne maitrisez pas encore ces fonctionnalites. 

Flash Basic 8 ou Flash Professionnel 8 

Flash 8 est desormais decline en deux versions : Flash Basic 8 et Flash Professionnel 8 (Flash Pro). 
Nous etudierons les fonctionnalites specifiques a la version Pro. La majorite des applications presentees 
dans cet ouvrage peut etre realisee avec la version de base, mais pour realiser des animations Flash 
avancees, 1' ideal est de disposer de la version Pro. 

Outre les fonctions disponibles dans la version standard de Flash 8, Flash Professionnel 8 propose les 
fonctions suivantes : 

• Un editeur integre de fichier ActionScript externe (.as) — Avec cet editeur, il n'est plus necessaire de 
faire appel a un editeur externe pour rediger les fichiers de declarations de classe ou autres fichiers 
de librairies de fonctions externes. Cet editeur integre met a votre disposition une assistance a la 
saisie de code ActionScript. 

• Un environnement visuel de programmation par ecran — Vous pouvez creer deux types d'ecrans 
differents dans ce mode de programmation : des diapositives (presentations sequentielles) et des 
formulaires. Un diaporama Flash utilise des diapositives comme type d'ecran par defaut (le 
comportement par defaut permet aux utilisateurs de naviguer entre les diapositives a l'aide de 
touches flechees). Une application de formulaires Flash utilise des formulaires comme type d'ecran 
par defaut. Toutefois, vous pouvez melanger des diapositives et des formulaires dans un meme 



Environnement de developpement 

Parte I 



document compose d'ecrans, afin de tirer profit de leurs fonctionnalites respectives et de creer une 
structure complexe dans une presentation ou une application. 

• De nouveaux composants avances (version 2) — Les nouveaux composants de 
Flash Professionnel 8 proposent de nouvelles fonctionnalites telles que la prise en charge de la 
gestion du focus qui permet, par exemple, de controler la navigation par tabulation. Pour informa- 
tion, le systeme des composants Flash permet aux programmeurs de creer des fonctionnalites puis 
de les encapsuler dans des composants que les concepteurs pourront ensuite utiliser et personna- 
liser dans leurs applications. 

• Un nouveau systeme de liaison des donnees — Ce nouveau systeme de liaison de donnees fournit 
une architecture souple basee sur des composants et un modele d'objet qui permet de se connecter 
a des sources de donnees externes (cote serveur), de gerer les donnees et de les lier aux composants 
d'interface utilisateur (cote client). Actuellement, les serveurs utilisant ces composants sont bases 
sur des technologies de type Cold Fusion, J2EE ou encore ASP.NET. 

• Des connecteurs de donnees predefinis pour les services Web et XML — De nouveaux composants 
vous permettent de vous connecter facilement aux services Web et aux sources de donnees XML 
(composant Tree, par exemple). 

• Un nouveau panneau de gestion de projet — Le panneau Projet permet la gestion centralisee de 
plusieurs documents dans une seule et meme entite projet (les informations d'un projet sont 
memorisees dans un fichier XML portant F extension .flp). Ce nouveau type d' element Flash 
permet de regrouper plusieurs fichiers associes pour creer des applications complexes. De plus, des 
fonctions de controle de la version permettent de s'assurer que Ton travaille sur les versions de 
fichiers adequates, afin d'eliminer tout risque d'ecrasement accidentel des informations (ideal pour 
des utilisateurs qui travaillent en equipe). 

Decouverte de I'interface 



En cas de probleme d'affichage dans Internet Explorer 

Si vous rencontrez des problemes d'affichage de votre page HTML contenant I'application Flash dans le navigateur 
Internet Explorer, reportez-vous a la fin du chapitre 24 pour connaitre la procedure a suivre afin de resoudre ce 
probleme. 



Utilisez la version de Flash 8 dont vous disposez et commencons la presentation de I'interface. Des 
le lancement de I'interface auteur, un panneau central s'affiche (voir figure 3-1). Sa partie haute est 
divisee en trois zones qui vous permettent d'ouvrir rapidement un element recent, de creer un nouvel 
element (avec Flash Pro plusieurs types d'elements sont proposes, voir figure 3-2) ou encore de creer 
un nouvel element selon un modele specifique (formulaire, diaporama, video...). Pour continuer la 
decouverte de I'interface, nous allons creer un nouveau document Flash en cliquant sur le petit 
dossier situe dans la partie gauche du panneau central (le panneau central doit ensuite etre remplace 
par la fenetre du scenario et la zone de la scene). 
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Figure 3-1 

Interface de Flash Basic 8 
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Figure 3-2 
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Les differents elements de I'interface 

Comme nous l'avons precise en debut de ce chapitre, toutes les fonctionnalites de I'interface ne 
seront pas presentees dans cet ouvrage. Cependant, il nous semble utile de rappeler les fonctions de 
ses elements principaux (voir figure 3-3) : 

• Zone de la scene — La scene est la zone de travail centrale de I'interface qui contient tous les 
elements de F animation (repere 1). 

• Fenetre du scenario — Le scenario permet d'organiser les differentes images d'une animation. 
Cette zone est constitute de lignes (les caiques) et de colonnes (les etapes de l'animation). L'inter- 
section d'une ligne et d'une colonne correspond a une image de la scene. Lors de la lecture d'une 
animation, la tete de lecture du Player se deplace d'une etape a F autre a la cadence definie dans 
l'animation (par exemple : 12 images par seconde) (repere 2). 

• Fenetre des proprietes — La fenetre des proprietes, appelee aussi Inspecteur de proprietes, 
permet de modifier les attributs d'un document ou objet sans avoir a acceder aux menus ou 
panneaux qui contiennent ces merries fonctionnalites. Selon ce qui est selectionne, la fenetre des 
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Figure 3-3 

Principaux elements de I'interface Flash 
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proprietes affiche d'une maniere contextuelle les informations et les parametres d'un document, 
d'un texte, d'un symbole, etc. (repere 3). 

• Barre d'outils principale — Permet d'acceder rapidement aux principaux outils pour creer ou 
modifier les differents elements d'une animation (repere 4). 

• Barre d'outils d'edition — Semblable aux barres d' edition que Ton retrouve dans la plupart des 
editeurs (Word, etc.), elle permet d'acceder aux taches usuelles de gestion d'un document (Nouveau, 
Ouvrir, Enregistrer, Copier, Couper, Coller, etc.) (repere 5). 

• Panneaux (Actions, Composant, Historique...) — De nombreux panneaux permettent de creer 
ou de parameter les elements d'un projet Flash. Ces panneaux sont classes selon leur usage (crea- 
tion graphique, developpement ou autres). Nous presentons en detail le panneau Actions plus loin 
dans ce chapitre (repere 6). 

• Barre des menus — Comme dans tous les logiciels, la barre des menus permet d'acceder a la tota- 
lite des fonctionnalites de 1' interface Flash. Ces memes fonctionnalites peuvent aussi etre activees 
par le biais des fenetres, panneaux et barres d'outils presentes precedemment (repere 7). 



Utilisez le menu contextuel et les raccourcis clavier 

Vous pouvez afficher un menu contextuel en cliquant sur le bouton droit de la souris (ou avec la touche Ctrl pour 
un Macintosh). Le menu est different selon la position du curseur et vous propose les commandes specifiques a 
I'element pointe. Par exemple, lorsque vous selectionnez une image dans la fenetre Scenario, le menu contextuel 
contient les commandes permettant de creer, de supprimer ou de modifier des images et des images cles. Des 
menus contextuels existent pour de nombreux elements et controles des differents emplacements, tels que la 
scene, le scenario, le panneau Bibliotheque ou le panneau Actions. 

L'utilisation des raccourcis clavier de Flash est une autre fagon d'acceder aux differentes taches de I'interface. De 
nombreux raccourcis clavier integres sont deja programmes mais vous pouvez les personnaliser selon vos habitu- 
des et meme ajouter une serie complete de raccourcis utilises dans une autre application (Fireworks, Illustrator, 
Photoshop...). Les raccourcis clavier correspondant aux differentes taches de I'interface sont affiches a droite de 
chaque option disponible depuis la barre de menus. Pour ajouter vos propres raccourcis clavier, il suffit d'afficher la 
fenetre Raccourcis clavier depuis le menu Edition puis Raccourcis clavier (ou Flash puis Raccourcis clavier pour un 
Macintosh). Au cours de cet ouvrage, nous indiquerons de nombreux raccourcis clavier et nous vous invitons a les 
memoriser et a les utiliser le plus souvent possible. 
Les menus contextuels et les raccourcis clavier vous font gagner du temps. 



Amenagez votre interface 

Dans sa configuration de base, I'interface de Flash 8 presente differents panneaux ancres par defaut a 
des endroits specifiques. Ces panneaux vous permettent d'afficher, d' organiser et de modifier les 
actifs et leurs attributs. lis peuvent etre deplaces en cliquant sur la poignee situee a gauche de la zone 
de titre, et en maintenant le bouton de la souris enfonce lors de leur deplacement vers l'endroit desire. 
Les panneaux peuvent aussi etre affiches, masques pour laisser la scene apparente (la touche F4 
masque ou affiche tous les panneaux) ou redimensionnes. Si certains panneaux n'apparaissent pas 
dans I'interface, vous pouvez les activer (ou les desactiver) depuis le menu en selectionnant Fenetre 
puis en cochant (ou decochant) le panneau desire dans la liste du menu deroulant ou dans la sous-liste 
Autres panneaux. 
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Afin d'obtenir F environnement le plus adapte au developpement d'ActionScript, nous vous 
conseillons de deplacer le panneau Actions dans la partie droite de F interface et d'activer la fenetre 
Bibliotheques. Si votre ordinateur dispose de deux ecrans, nous vous conseillons de detacher le 
panneau Actions de l'interface Flash et de le placer dans le second ecran afin de pouvoir ajuster sa 
dimension librement. Vous pouvez evidemment effectuer d'autres modifications de F environnement 
par defaut pour F adapter a vos besoins. 

Une fois Fagencement des panneaux realise, enregistrez-le en lui attribuant F etiquette « developpe- 
ment ». Pour cela, selectionnez Fentree Fenetre depuis le menu puis Presentation de Fespace de 
travail et enfin Enregistrez la presentation active. Une fenetre apparait. Saisissez « developpement » 
dans le champ de cette fenetre puis validez. La disposition de vos differents elements d'interface est 
maintenant memorisee. Pour revenir a la disposition par defaut depuis le menu Fenetre, selectionnez 
Presentation de Fespace de travail puis Par defaut. Pour rappeler la disposition precedemment enre- 
gistree, selectionnez son etiquette (soit developpement) dans la liste des options de Fentree Presentation 
de Fespace de travail (voir figure 3-4). 
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Figure 3-4 

Modification de I'agencement des panneaux 
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Le panneau Actions 

Le panneau Actions perniet de creer et de mettre ail point des lignes de codes ActionScript associees 
a un gestionnaire d'evenement ou integrees a une image. Dans la section precedente, nous avons 
configure 1' interface Flash afin que le panneau Actions soit toujours actif et place dans la partie droite 
de Finterface. S'il n'est pas visible, vous pouvez Factiver par le menu en selectionnant 1' entree Fenetre 
puis l'option Panneaux de developpement et Actions. Pour derouler le panneau Actions, il suffit de 
cliquer sur la petite fleche situee dans la zone de tete du panneau ou d'utiliser le raccourci clavier F9. 

Le panneau Actions est divise en trois parties (voir figure 3-5) : 

• Editeur de script — zone de saisie du code (repere 1). 

• Boite a outils — liste des commandes classees par themes (repere 2). 

• Navigateur de script — affiche la structure hierarchique des elements de F animation et permet 
d'afficher dans la fenetre de script le code place sur un element par une simple selection de ce 
dernier dans Farborescence (repere 3). 
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on (press) ( 

trace ("clxc") ; 



Figure 3-5 

Les trois parties du panneau Actions 



II est possible de modifier Fapparence du panneau Actions en affichant le navigateur de script dans sa 
partie gauche (en cliquant sur le bouton A de la figure 3-6) ou en affichant la fenetre de script dans 
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1 stopO; 

2 trace ("bonjout") ; 
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Bouton B 



Figure 3-6 

Le^ deux boutons A etB permettent d'afficher ou de masquer certaines zones du panneau Actions. 




Figure 3-7 

Les ressources etant aussi accessibles depuis le bouton + de lafenetre de script, la zone de la boite a outils 
est done souvent masquee. 



toute la zone du panneau (en cliquant sur le bouton B de la figure 3-6). Vous pouvez ainsi adapter la 
configuration du panneau a votre niveau et a vos besoins (voir figure 3-6). En pratique, la boite a 
outils est frequemment masquee car les ressources sont disponibles a partir du bouton + de la fenetre 
de script (voir figure 3-7). 

Dans les versions precedentes de Flash, il existait deux modes d'edition : le mode Normal (mode 
assiste dans lequel vous completiez des options et des parametres pour creer du code) et le mode 
Expert (mode destine aux programmeurs confirmes dans lequel vous ajoutiez des commandes direc- 
tement dans la fenetre de script). L'editeur ActionScript de Flash 8 ne propose plus desormais qu'un 
seul mode d'edition dont nous allons vous presenter les particularites. 
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Oil devez-vous enregistrer vos scripts AS ? 

Vos fichiers ActionScript peuvent etre enregistres dans le repertoire de votre choix. Cependant, comme vous serez 
amene par la suite a tester vos documents Flash en interaction avec des programmes PHP, il est judicieux d'enre- 
gistrer des maintenant vos scripts AS dans un sous-repertoire du dossier www de Wamp 5 (www est la racine du 
serveur local). Par exemple, pour les scripts de demonstration presentes ci-apres, nous avons cree un repertoire 
nomme SITEf 1 ash place dans le dossier racine www de Wamp 5 dont voici le chemin complet : 
C: \wamp\www\SITEf 1 ash\ 



Le navigateur de script 

Le navigateur de script est une des nouveautes de Flash 8. C'est une representation visuelle de la 
structure de votre fichier FLA qui vous permet de le parcourir pour localiser rapidement du code 
ActionScript. 

Pour ajouter du code ActionScript a une animation, il faut en premier lieu selectionner l'element sur 
lequel sera integre le code (image cle du scenario, clip ou bouton). Si aucun element valide n'est 
selectionne, la saisie de code est impossible. La premiere branche du navigateur de script Selection 
actuelle indique quel element est selectionne sur la scene (voir figure 3-8). Lors de l'ouverture d'un 
nouveau document Flash, c'est la premiere image cle qui est selectionnee par defaut. Des qu'une 
ligne de code a ete ajoutee a un element, il apparait dans la seconde branche du navigateur de script 
correspondant a la sequence en cours : Sequence 1 (si l'element est place directement sur le scenario 
principal) ou dans la branche Definition des symboles portant le nom du clip parent (s'il s'agit d'un 
clip enfant place sur un clip pere)(voir figure 3-8). La branche Definition des symboles represente les 
symboles (semblable au contenu de la bibliotheque) avec les differentes images cles comportant du 
code de leur scenario respectif. 



A noter 

Pour qu'un symbole puisse etre accessible depuis la branche Definition des symboles, il faut qu'au moins une des 
images cles de son scenario possede une ligne de code ou qu'un element enfant lui soit attribue. 



Lorsque plusieurs elements comportent du code, vous pouvez ensuite passer de Fun a F autre par une 
simple selection (un seul clic) de l'element desire dans la branche Sequence 1 ou dans Fune des bran- 
ches Definition des symboles s'il y a plusieurs niveaux de clip (le code de l'element selectionne 
s'affiche alors dans la fenetre de script). 

Dans l'exemple de la figure 3-8, l'element selectionne monCl ipEnfantl_mc est place sur un clip parent 
monCl i pl_mc, lui-meme place sur le scenario principal. 

II est egalement possible de verrouiller un script specifique en realisant un double-clic sur l'element 
auquel il est attache. Lorsqu'un script est verrouille, il est accessible grace aux onglets places en bas 
de la fenetre (voir figure 3-9). On peut ainsi verrouiller plusieurs script et passer de Fun a Fautre tres 
rapidement (Fonglet le plus a gauche affiche toujours la selection effectuee dans la structure du 
FLA). Pour deverrouiller une fenetre de script, il suffit de la selectionner et de cliquer sur la petite 
punaise situee a droite du premier onglet. 
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Figure 3-8 

La selection d'un element dans le navigateur de script permet d'ajficher le code en rapport dans lafenetre 
de script. Notez que V element selectionne est indique en bas de la fenetre de script. 




Figure 3-9 

// est possible de verrouiller une ou plusieurs fenetres de script en double-cliquant dans le navigateur 
de script sur V element auquel est attache le script. Dans I'exemple de cette figure, deux scripts sont 
verrouilles ; I'onglet le plus a gauche affiche toujours le code selectionne dans le navigateur de script. 

La boite a outils 

II existe plusieurs possibilites pour ajouter du code dans la fenetre de script. La premiere solution consiste 
a utiliser les commandes classees par themes disponibles dans la boite a outils du panneau Actions. 

Avant d' ajouter le code, il faut d'abord selectionner 1' element auquel vous desirez associer une 
commande. Si l'element possede deja du code, il est present dans la branche Sequence 1. Vous 
pouvez alors le selectionner directement a partir du navigateur de script (voir ci-dessus), sinon il faut 
le selectionner sur la scene (s'il s'agit d'un clip ou d'un bouton) ou depuis le scenario (si vous desirez 
ajouter du code a une image cle). 
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Remarquez que des qu'un element est selectionne, le titre du panneau Action change en rapport avec 
le type de l'element selectionne. Si l'element selectionne est une image, le titre sera Actions - 
image ; si l'element est un objet (clip...), le titre sera Actions - Objet et enfin si l'element selectionne 
est un bouton, le titre sera Actions - Bouton. 

Une fois l'element selectionne, deroulez les themes de la boite a outils arm de localiser la commande 
a inserer. Vous pouvez ensuite ajouter cette commande par un simple glisser-deposer de la boite a 
outils vers la fenetre de script (voir - figure 3-10) ou en effectuant un double-clic sur l'icone de la 
commande dans la boite a outils. Completez la commande si elle necessite des parametres puis 
recommencez en suivant la meme procedure pour ajouter les autres instructions du script. 



A noter 

Lorsque vous positionnez votre pointeur sur un element du langage ActionScript dans la boite a outils, vous pouvez 
utiliser I'option Afficher I'aide du menu contextuel (die droit de la souris) pour afficher une page d'aide concernant 
cet element. 

D'autre part, selon la version du Player Flash que vous avez definie dans les parametres de publication (menu 
Fichier>Parametres de publication), certaines commandes peuvent s'afficher en jaune afin de vous signaler 
qu'elles ne doivent pas etre exploitees pour la version de Player selectionnee. 



Dans l'exemple de la figure 3-10 nous avons ajoute une commande stopO a l'image cle 1. Des 
qu'une ligne de commande est ajoutee a l'image, un petit « a » apparait dans le scenario sur l'image 
cle concernee. 
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Figure 3-10 

Ajout d'une commande par glisser-deposer depuis la boite d outils 

L'editeur de script du panneau Actions 

L'editeur de script du panneau Actions permet de saisir du code directement dans la zone de saisie. II 
est egalement possible d' ajouter une commande en cliquant sur le bouton Ajouter + (situe en haut de 
l'editeur, voir figure 3-11) afin d'acceder a une liste des commandes semblable a celle de la boite a 
outils (revoir figure 3-7). 
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Un menu situe en haut du panneau permet d'acceder a de nombreuses fonctions : 

• Ajouter un element - permet de selectionner une commande dans une liste des commandes 
ActionScript classees par themes et de Finserer dans la zone d'edition de Fediteur de script (voir 
figure 3-11). 
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Figure 3-1 1 

Le bouton + de lafenetre de script permet d'acceder a une liste des commandes classees par themes. 
Un simple clic sur la commande selectionnee permet de V ajouter dans la zone d'edition a Vendroit du 
curseur. Notez que les raccourcis Echap permettant d'inserer la commande directement a partir du clavier, 
sont indiques a droite de leur nom dans la liste. 

• Rechercher et remplacer - permet de lancer une recherche par rapport a un mot precis afin de 
localiser rapidement la zone de code correspondante (voir figure 3-12). Ce meme bouton peut 
aussi etre utilise pour realiser un remplacement du mot recherche au coup par coup comme auto- 
matiquement (voir figure 3-13) 




Figure 3-12 

Recherche des endroits oit se trouve le mot-cle saisi 
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Recherche et remplacement d'un 
mot specifique dans le code 
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• Chemin cible - permet d'inserer rapidement et sans risque d'erreur de frappe le chemin corres- 
pondant a un element cible. Le chemin peut etre insere en mode relatif (par rapport ail scenario 
dans le quel sera ajoute le code : this) ou en mode absolu (par rapport au scenario principal : 
_root) (voir figure 3-14). Pour qu'un element puisse etre insere dans le code de cette maniere, il 
faut que son nom d' occurrence soit renseigne au prealable. 




• Verifier la syntaxe - permet de verifier la syntaxe du script sans necessairement passer en mode 
de test (voir figure 3-15). 



Figure 3-15 

Verification de la syntaxe du script 
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• Format automatique - permet de formater automatiquement les lignes de code du script en appli- 
quant Findentation ideale pour avoir une bonne lisibilite du script concerne (voir figure 3-16). 
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Figure 3-16 

Applique V indentation ideale aux differentes lignes de code de la zone d' edition. 



• Afficher les conseils de code - permet d'afficher les informations de F assistant (sous forme 
d'infobulles) en rappelant la syntaxe a laquelle doit repondre la commande. Avant d'activer cette 
fonction, vous devez positionner le curseur a l'endroit correspondant a la commande a renseigner 
(en general juste apres la parenthese ouvrante, voir figure 3-17). 
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Figure 3-17 

Affiche les informations de V assistant de code. 
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• Option de debogage - permet de creer ou de supprimer des points d' arret qui seront utilises pour 
le debogage du script. L'ajout et la suppression des points d'arret peuvent etre aussi geres par un 
simple clic dans la zone bleue a gauche de la ligne de code (voir figure 3-18). 



Figure 3-18 

L' option de debogage permet 
d'ajouter ou de supprimer 
des points d'arret. 
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Attention ! 

Depuis l'ajout de cette nouvelle fonctionnalite, ilfaut appuyersur latouche Ctrl (ou Commande pour un Macintosh) 
et cliquer sur une ligne de code pour la selectionner (alors que dans les versions anterieures, il suffisait de cliquer 
sur la ligne pour la selectionner). 



• Reference - permet d' afficher rapidement les caracteristiques correspondant a la commande selec- 
tionnee dans le panneau de l'aide. Avant d'activer cette fonction, le curseur doit etre positionne sur 
la commande a renseigner (voir figure 3-19). 
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Guide de reference du langage Action 
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Figure 3-19 

Affiche I 'aide correspondant a la commande selectionnee. 
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A noter 

Une fonctionnalite semblable a celle du bouton Reference peut etre obtenue par le menu contextuel (die droit puis 
option Afficher I'aide) en selectionnant au prealable la commande dans la fenetre de script. 



• Assistant de script - Pour activer F assistant de script, il suffit de cliquer sur le bouton du meme 
nom situe a droite de la serie de boutons que nous venons de detailler. Une fois en mode assistant, 
vous n'aurez plus aucune possibilite de modifier le code manuellement dans la zone de saisie (vous 
pouvez toutefois supprimer une partie de code, apres 1' avoir selectionnee, en cliquant sur la touche 
Suppr de votre clavier). Pour developper votre programme, vous devrez ajouter une a une les diffe- 
rentes fonctions en utilisant le bouton + de Fediteur de script ou a I'aide de la boite a outils. Pour 
chaque fonction ajoutee, vous pourrez ensuite parameter un formulaire contextuel pour choisir ses 
options (voir figure 3-30). Ce mode est principalement destine aux utilisateurs qui ne maitrisent 
pas encore Fecrifure de scripts a Faide de Fediteur de script. Notez que ce systeme existait deja 
dans la version 6 de Flash (Flash MX) sous F appellation mode normal. II avait ete ensuite 
supprime dans la version 7 (MX 2004) et reapparait maintenant avec la version 8 sous la forme 
legerement amelioree de cet assistant de script. 



Figure 3-20 

L' assistant de script permet de 
saisir du code automatiquement 
en selectionnant Taction a 
realiser (a I'aide du bouton + 
de Fediteur de script ou 
a partir de la boite a outils) 
puis en parametrant simplement 
des formulaires d' options. 
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• Menu Option du panneau Actions - Pour acceder a ce menu, il suffit de cliquer sur le petit 
bouton situe en haut a droite du panneau. Ce menu permet d' acceder a de nombreuses options et 
vous permettra, par exemple, d'afficher les touches de raccourci Echap et les numeros de ligne, ou 
encore de gerer le retour a la ligne dans la zone de saisie. L'affichage des numeros de ligne est tres 
utile pour localiser une erreur lors du debogage de votre programme : en general, les messages 
d'erreur indiquent le numero de la ligne dans laquelle se trouve le probleme. 

Utilisation du panneau Actions 

Que votre code soit lie a un objet clip, a un bouton ou integre dans une image cle, vous devrez utiliser 
le panneau Actions pour le saisir. Dans le cas de code associe a des images cles, il est preferable de 
regrouper les differentes instructions dans la premiere image du scenario. Ainsi, votre code ne sera 
pas eparpille et vous ne serez pas oblige de le rechercher dans les differentes images cles du docu- 
ment. De meme, il est conseille de creer un caique appele Actions et d'y placer exclusivement du 
code. Ainsi, meme si votre application necessite de placer du code dans differentes images cles, il 
vous suffira de consulter ce caique pour le retrouver. 



A noter 

Si vous desirez creer des scripts externes, vous devrez utiliser votre editeur de texte prefere ou, dans Flash Profes- 
sionnel, la fenetre de script (editeur de fichier externe integre dans I'interface de Flash — voir ci-apres). Toutefois 
que vous utilisiez le panneau Actions ou la fenetre de script, le fonctionnement de I'editeur ActionScript est iden- 
tique (hormis le navigateur de script, qui n'est pas disponible dans la fenetre de script). 



Insertion d'une commande a I'aide de I'assistant de script 

Nous avons deja presente I'assistant de script dans la partie precedente. Nous nous contenterons ici 
de rappeler les actions a effectuer pour utiliser cet assistant (revoir la figure 3-20 si besoin) : 

• Activez 1' assistant de script en cliquant sur le bouton Assistant de script dans la barre de menus de 
I'editeur de script. Une zone grise doit alors apparaitre au dessus de la barre de menus de I'editeur 
de script (voir repere 1 de la figure 3-20). 

• Inserez la commande de votre choix a I'aide des menus de la boite a outils ou du bouton + de 
I'editeur de script en suivant les procedures ci-dessous : 

- Avec la boite a outils - selectionnez la commande desiree dans le menu de la boite a outils et 
faites-la glisser dans la zone de saisie (F insertion peut aussi etre declenchee en double-cliquant 
sur la commande). 

- Avec le bouton + de I'editeur de script - cliquez sur le bouton Ajouter + situe a gauche du 
menu de I'editeur de script. Selectionnez ensuite les differentes categories de classement des 
commandes et cliquez sur la commande desiree (voir repere 2 de la figure 3-20). 

• Completez le formulaire correspondant aux differentes options de la commande selectionnee. Ce 
formulaire doit apparaitre dans la zone grise situee au-dessus de la barre de menus de I'editeur de 
script (voir repere 3 de la figure 3-20). 

• Renouvelez ensuite successivement ces deux dernieres etapes pour ecrire le reste de votre 
programme. Notez que la seule action manuelle que vous pouvez realiser avec I'assistant est de 



Environnement de developpement 

Parte I 



supprimer un bloc de code. Pour cela, il suffit de selectionner le bloc desire et de cliquer sur la 
touche Suppr de votre clavier. 

Insertion semi-assistee d'une commande 

Le mode semi-assiste permet de d'utiliser les menus deroulant de la boite a outils ou le bouton + de 
l'editeur de script tout en restant libre de pouvoir modifier manuellement le code ainsi genere. Le 
choix des parametres de la fonction ajoutee sera tout de meme facilite par F utilisation des conseils de 
code disponibles depuis l'editeur de script. 

Vous pouvez inserer une commande en mode semi-assiste dans la zone de saisie de l'editeur de script 
de deux facons differentes : 

• Avec la boite a outils - selectionnez la commande desiree dans le menu de la boite a outils et 
faites-la glisser dans la zone de saisie (l'insertion peut aussi etre declenchee en double -cliquant sur 
la commande). 

• Avec le bouton + de l'editeur de script - cliquez sur le bouton Ajouter + situe a gauche du menu 
de l'editeur de script (voir figure 3-21). Selectionnez ensuite les differentes categories de classe- 
ment des commandes et cliquez sur la commande desiree. 
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Ces deux procedures evitent d' avoir a rediger toutes les commandes et reduisent considerablement 
les erreurs de saisie. 

Les touches de raccourcis Echap 

Lors de la saisie directe d'un code, il est egalement possible d'utiliser des touches de raccourcis 
Echap, afin d'ajouter rapidement des commandes ou des structures de code. Cette fonction est parti- 
culierement efficace et nous vous invitons a Futiliser sans moderation dans la redaction de vos futurs 
programmes. Pour utiliser une touche de raccourci Echap, vous devez commencer par appuyer sur la 
touche Echap de votre clavier (en haut a gauche) puis taper les deux lettres correspondant au code de 
la commande. Pour connaitre les differents codes, consultez la boite a outils (les codes sont affiches 
a droite de chaque commande). Par exemple, si vous saisissez la sequence Echap suivante : Echap + f 
+ n, vous afficherez la structure d'une declaration de fonction dans la zone de saisie et votre curseur 
sera place a droite du mot-cle function, pret a saisir le nom de la fonction a creer : 

I function _ ( ) { 
I > 

Apres la saisie du nom, il suffit d'appuyer sur les touches Fi n puis Entree de votre clavier pour placer 
le curseur entre les deux accolades et completer votre structure en saisissant les differentes lignes de 
code du bloc de la fonction. 



» Action* Clip 

■fe J3 © V I (5 V. 



\ Assistant ckucnpc 



I onClipEvent i ) 




® unload 
® entct Ft ame 

maiumpour afficher cette structure, 
®m««op taper successivement sur 
v les touches suivantes 



"Echap" puis "o" et "c" 



Figure 3-22 

Insertion d'une structure de code a Vaide des combinaisons de touche Echap. Dans cet exemple, 
nous axons appuye sur la touche Echap puis successivement sur la touche O puis C pour inserer 
une structure onClipEvent() dans la zone de saisie. 



Conseils de code 

Lorsque vous travaillez dans Fediteur ActionScript (dans le panneau Actions ou dans la fenetre de 
script), Flash peut detecter Taction que vous lancez et afficher un conseil de code (une infobulle 
contenant la syntaxe complete de Taction en cours ou un menu contextuel repertoriant des noms de 
proprietes ou des methodes possibles). Les conseils de code apparaissent pour les parametres, 
proprietes et evenements si vous avez utilise les suffixes recommandes par Macromedia pour chaque 
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objet (exemple : _mc pour un objet MovieClip) ou si vous avez declare strictement vos objets de sorte 
que l'editeur ActionScript sache quel conseil de code afficher. 

Conseils de code pour element type strictement 

Les objets issus de classes integrees peuvent etre types strictement lors de leur instanciation (exemple : 
var monTabl eau: Array=new Array ( ) ; . Le typage strict sera presente en detail dans le chapitre 7). Dans ce 
cas, l'editeur peut reconnaitre son type des que Ton saisit Fidentifiant de Fobjet dans l'editeur. II lui est 
alors possible d'afficher des conseils de code relatifs au type de Fobjet reconnu. En pratique, une info- 
bulle affiche la liste des methodes et proprietes disponibles pour Fobjet identifie des que vous saisissez 
le nom de Fobjet suivi d'un point (exemple : monTabl eau ., voir figure 3-23). 



» Actions - Clip 

D'- 



\ Assistant de scnpt 



65, 



I var loonTableau: Array new Array (): 



® concat ~ 



® pop 
® push 
® reverse 
® srrft 
O ske 



[jS n>oi>Cli>l„r»c) ^ 

e 2 de 2, Col 12 



Figure 3-23 

Affichage de conseils de code pour un objet strictement type 



Conseils de code pour element avec suffixe 

II existe une seconde solution pour afficher automatiquement des conseils de code. Pour cela, vous 
devez ajouter un suffixe special au nom de chaque objet lors de sa creation. Par exemple, le suffixe 
qui doit etre ajoute a un identifiant d'objet de la classe Array est _array. Un tableau des differents 
suffixes est disponible dans Faide de Finterface Flash. Ce tableau figure aussi dans la section concernant 
les identifiants utilises en ActionScript du chapitre 7 de cet ouvrage. 

Si vous declarez un objet tableau en utilisant la syntaxe suivante : 

Var monTabl eau_array = new ArrayO; 

vous pourrez ensuite beneficier de F affichage des conseils de code lors de F utilisation du nom de 
Fobjet dans l'editeur de script. Les conseils de code apparaissent des l'ajout du point (.) place apres 
le nom de Fobjet comme dans l'exemple ci-dessous. 

| MonTabl eau_array. 

Vous pourrez choisir dans la liste la propriete ou la methode de Fobjet que vous desirez inserer dans 
votre script (voir figure 3-24). 
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Figure 3-24 

Affichage de conseils de code 
pour un objet avec suffixe 




Dans le cas oil l'objet serait cree sur la scene (MovieCl ip, Button, Champ texte), vous devrez saisir 
l'identifiant avec son suffixe (monCl ipl_mc, par exemple) dans le champ du nom d'occurrence du 
panneau des proprietes (voir figure 3-25). 



▼ Proprietes Ftoes 1 Parametres 




Occurrence de : monCtp.mc 
[ Permuter | 


Couleur : Aucun v| 

— ® 


L ; 1 65.0 | X :| 258.0 | 
8 H:[65.0 J Y:[l9S.O | 


Melange : Normal v © 
Q Wiser la mise en cache des bitmaps a ^execution 



Figure 3-25 

Le fait d'attribuer un nom d 'occurrence avec suffixe a un MovieClip permet de disposer des conseils de code 
lors de la saisie de son identifiant suivi d'un point dans I 'editeur de code. 



Les suffixes d'identifiant 

Meme si les suffixes d'identifiant ne sont pas necessaires au declenchement des conseils de code lorsque vous 
definissez strictement le type d'un objet, nous vous conseillons de toujours appliquer cette convention de 
nommage afin d'ameliorer la lisibilite de vos programmes. 



Options de I'editeur ActionScript 

Certains reglages de I'editeur de code peuvent etre configures depuis la fenetre Preferences (voir 
figure 3-26) de Finterface (menu Edition>Preferences ou avec le raccourci Ctrl + U, puis cliquer sur 
l'onglet ActionScript). 
Vous pourrez ainsi valider ou invalider : 

• L'indentation automatique - facilite la lisibilite du programme en decalant certaines lignes de 
code d'une tabulation. La valeur de cette tabulation peut etre definie. 

• Les conseils de code - permet d'afficher les conseils de code si Felement est strictement type ou 
si un suffixe a ete ajoute a son identifiant (voir ci-dessus). Le delai d'affichage des conseils de code 
peut etre ajuste afin de ne pas perturber votre saisie si vous etes un programmeur confirme. 
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Remarque 

Si vous rejetez cette option, vous aurez toujours la possibility d'afficher les conseils de code a la demande a I'aide 
du bouton Afficher les conseils de code du menu de I'editeur de script. 

• Police et taille du texte - peimet de choisir la police ainsi que la taille du texte utilise dans I'editeur de 
code. II est conseille de le desactiver par defaut pour le mappage des polices dynamiques car il ralentit 
les performances lors de la programmation, sauf si vous travaillez avec des textes multilingues. 

• Coloration de la syntaxe - permet de mettre en evidence certaines parties d'un script en leur attri- 
buant des couleurs differentes arm d'en faciliter la lecture et de detecter d'eventuelles erreurs de 
syntaxe. Ces options permettent de modifier les couleurs attributes par defaut aux differentes 
parties : texte courant (premier plan), fond de I'editeur (second plan), mots-cles, identifiants de 
variable, chaines et commentaires. Cela vous permet, le cas echeant, d' adapter la coloration 
syntaxique de I'editeur AS a celle de votre editeur de code habituel. 

• Parametres d'ActionScript 2.0 - ce bouton permet d'acceder a une fenetre de configuration des 
chemins de classe (pour plus de detail sur les chemins de classe, reportez-vous au chapitre 
consacre a AS et a la POO - programmation orientee objet). 





1 




ActionScript 



Mod* ication : 0 Indentation automatique 



0Consefc decode 



Taille des tabulations : 




0 seconder 



Police : |Courler New 1 10 J[ 

□ utiserle mappage de police dynamique 




Enreglstrer/Exporter : Codage UTF-8 J 



Recharger les fichlers modules : Invite 



Couleurs de la syntaxe : 0 Coloration du code 



Premier plan : Jl Atneie-plan : 

Mots-cles : Wi Commentaires : Wfi 

Identifiants : Wl Charas : Wj 



Langage : | Parametres d'ActionScript 2.0. . . 



Valeurs par defaut 



\ OK 



] | Annuler | 



Figure 3-26 

La configuration des options de I'editeur ActionScript pent etre realisee a I'aide de la fenetre Preferences. 
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Dans la version Flash Professionnel, un editeur integre a V interface permet de creer des fichiers 
externes. Vous pouvez ainsi beneficier de Fassistance a la programmation de I'editeur de script Flash 
(voir ci-dessus) et enregistrer vos codes dans des fichiers externes sans utiliser un autre editeur. 



Remarque 

Les utilisateurs de Flash Basic 8 peuvent aussi creer des fichiers externes, mais ils devront pour ce faire utiliser 
leur editeur de code favori qui ne beneficiera pas de I'assistance a la programmation AS. 



Pour creer un fichier de code externe, il faut utiliser le suffixe .as comme extension afin que les scripts 
inclus soient identifies en tant que code ActionScript (AS). Cette possibilite est particulierement interes- 
sante pour enregistrer des fonctions dans des bibliotheques ou pour creer des classes ActionScript 2.0. 



A noter 

Chaque classe doit etre enregistree dans un fichier .as specifique et porter le meme nom que la classe concernee. 
Pour acceder au code stocke en externe, il suffit d'integrer une instruction #include dans le document FLA 
concerne. 



Attention ! 

Lors de la publication, de I'exportation, du test ou du debogage d'un fichier FLA, le code ActionScript enregistre 
dans des fichiers externes est compile dans le fichier SWF. Par consequent, lorsque vous modifiez un fichier 
externe vous devez I'enregistrer puis recompiler tout fichier FLA qui I'utilise. 



L'interface de la fenetre de script est identique a celle de I'editeur de script du panneau Actions, 
hormis le fait que tous les autres panneaux avoisinants sont inactifs (grises). La coloration de la 
syntaxe, les conseils de code et d' autres preferences sont aussi pris en charge par I'editeur. Une boite 
a outils identique a celle du panneau Actions est egalement disponible. 

Pour afficher I'editeur de fichiers externes integre, cliquez sur Fichier>Nouveau, puis selectionnez le 
type de fichier externe a creer (voir figure 3-27). Vous pouvez ouvrir plusieurs fichiers externes 
simultanement ; les noms des fichiers s'affichent alors dans des onglets en haut de la fenetre de script 
(cette fonction est uniquement disponible sous Windows). 



s 
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//declaration de la superclasse voiture -------------- 

class vol cure < 

//---------declaration des propnetes utilisees 

var couleur:Stnng; 
vac vitesse:Nmitoer; 

//---------declaration du coast r ucteur 

£unct ion voiture (choix_couleur : Seeing) ( 
Vitesse - 0; 

//Initialise la Vitesse a 0 
couleur - cholxcouleur; 

// La couleur est afxectee selon le paranetre 



// declaration des method* a comwnes a la clasae "voiture" 

function accelererl) { 
vltess«++j 

// Incretnente la Vitesse si on accelere. 



function freinerO { 



U**J in ficNtr AAonSovt (*.M) Ottrr* «4 m*jr«-te 
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Figure 3-27 

L'editeur defichiers externes integre a Vinterface Flash permet de disposer des memes fonctionnalites 
que celles de l'editeur de script du panneau Actions. 



Le mode test de Flash 

Passage en mode test 

Pour tester un document Flash, vous pouvez ouvrir votre animation en mode test dans un fichier SWF 
depuis 1' interface auteur de Flash. Pour passer en mode test, selectionnez le menu Controle, puis 
Foption tester l'animation, ou utilisez directement le raccourci clavier Ctrl + Entree. 



A noter 

Dans le cas d'animations possedant plusieurs sequences, il est possible de ne tester que la sequence active 
(selectionnez le menu Controle, puis tester la sequence ou utilisez le raccourci clavier Ctrl + Al t + Entree). 
De meme, mais uniquement pour les utilisateurs de la version professionnelle, il est possible de tester tous les 
documents Flash regroupes dans un meme projet (selectionnez le menu Controle, puis tester le projet ou utilisez 
le raccourci clavier Ctrl + Alt + P). 
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EKtw ftfflchage £ontrcte Oefeoguer 




La ligne de code ci-dessous a etc ajoutee au bouton B 
/ trace("la nouvelle valeur de X est :"+this._x) 




» Sortie !?. 



la nouvelle valeur de X est :56 
la nouvelle valeur de X est :61 
la nouvelle valeur de X est :66 
la nouvelle valeur de X est :71 
la nouvelle valeur de X est :76 
la nouvelle valeur de X est :8l 



Figure 3-28 

Interface du mode test d'une animation. Dans cet exemple, une instruction trace() a ete ajoutee au bouton B. 
Ainsi, a chaque die sur ce bouton, la nouvelle coordonnee de la voiture s 'affiche dans le panneau Sortie. 

Le panneau Sortie 

En mode test, le panneau Sortie affiche des informations facilitant le depannage de votre fichier SWF. 
Certaines de ces informations, telles que les erreurs de syntaxe, s'affichent automatiquement. 
D'autres informations sont disponibles a l'aide des commandes Lister les objets et Lister les 
variables accessibles depuis le menu du mode test (menu Deboguer>Lister les objets ou Lister les 
variables). Si vous utilisez r instruction trace( ) dans vos scripts, vous pouvez envoyer des informations 
specifiques au panneau de sortie au cours de l'execution du fichier SWF. II peut s'agir d'un simple 
texte d'information ou de la valeur d'une variable (voir figure 3-28). 



Outre le mode test presente precedemment, vous pouvez activer un debogueur. Le debogueur permet 
de visualiser revolution de differentes valeurs de F animation (variables, proprietes, etc.) afin de 
reperer d'eventuelles erreurs lors du deroulement de Fanimation. Le debogueur dispose d'une fonc- 
tionnalite points d' arret (points ajoutes a un script afin d'arreter temporairement son execution). 
Cette fonction tres interessante permet d'executer le programme pas a pas afin d'observer revolution 
des valeurs d'une ligne de code a 1' autre. 

Pour passer en mode test et activer le debogueur, ouvrez le menu Controle, puis selectionnez 1' option 
Deboguer l'animation ou utilisez le raccourci clavier Ctrl + Maj + Entree. 



Le mode debogage de Flash 

Activer le debogueur 
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Le debogueur 

En mode debogage (mode test avec le debogueur active), le debogueur est automatiquement mis en 
pause afin de vous permettre d'ajouter d'eventuels points d'arret dans vos scripts. II faut ensuite 
cliquer sur le bouton de lecture (fleche verte situee dans la barre de commande du debogueur) pour 
que le debogage puisse commencer. 



Remarque 

Vous pouvez ajuster les fenetres du debogueur en tirant sur la barre de separation horizontale (voir figure 3-29). 



La fenetre du debogueur est composee de plusieurs zones, telles que representees sur la figure 3-29. 
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Figure 3-29 

Les differentes parties d'une interface de debogage 



Exemple d'utilisation du debogueur 

Des exemples d'utilisation du debogueur seront presentes a la fin de cet ouvrage dans le chapitre consacre a la 
mise au point de programmes ActionScript. 
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La liste hierarchique 

Lorsque le debogueur est active, il presente une vue de la liste hierarchique des elements de l'anima- 
tion principale (clips, champs texte, element _gl obal , etc.)- Lorsque vous ajoutez des clips au fichier 
ou en supprimez, la liste est immediatement mise a jour. Des que vous selectionnez un element de la 
liste, ses proprietes et ses valeurs sont affichees dans Fonglet concerne. Par exemple, dans la figure 3-30 
nous affichons les variables globales de F animation. 



▼ Debogueur 

Tester I'animation :fite:///C|/Program%20Files 




P «>) ($> 



•J actions sur voitur«_mc: Image 1 du clique Actions 



1 stop(); 

2 numero_txt.text=numero; 
Uau<iiLiu_L..l._i. l IMLilt Uuil ■ 

global. glob_maVanableGlobale="bonjour"; 



Figure 3-30 

La liste hierarchique presente V organisation hierarchique de tons les elements contenus dans I'animation 
principale. En selectionnant V element _global, vous pouvez controler les variables globales de la mime 
maniere que les variables attributes a un simple clip. 



Longlet Proprietes 

L'onglet Proprietes permet d'afficher et de modifier les valeurs des proprietes de l'element selec- 
tionne dans la liste hierarchique. II indique le nom et la valeur correspondante des proprietes couran- 
tes de F animation selectionnee. Pour modifier les valeurs des proprietes, double-cliquez sur le champ 
de la colonne Valeur, saisissez la nouvelle valeur dans le champ et validez en appuyant sur la touche 
Entree. 



A noter 

Si certaines valeurs apparaissent grisees, leur modification n'est pas autorisee. Les valeurs saisies peuvent etre 
des chaines (delimitees par des guillemets), des valeurs numeriques ou des valeurs booleennes (true ou f al se). 
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Tester I'animation :file:///C|/Program%20Files, 
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levelO .voiturel mc 
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.quality 


HIGH 
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Figure 3-31 

L'onglet Proprietes permet d'afficher et de modifier toutes les proprietes de I' element selectionne 

dans la liste hierarchique. Dans notre exemple, le clip voiturel _mc est selectionne et on pent ainsi suivre 

I 'evolution de toutes les valeurs des proprietes du clip : _height, _rotation. .. et eventuellement les modifier. 



L'onglet Variables 

L'onglet Variables permet d'afficher et de modifier les valeurs des variables de 1' element selectionne 
dans la liste hierarchique. II indique le nom et la valeur correspondante des variables courantes de 
F animation selectionnee. Pour modifier les valeurs des variables, double-cliquez sur le champ de la 
colonne Valeur, saisissez la nouvelle valeur dans le champ et validez en appuyant sur la touche Entree. 



A noter 

II est possible d'afficher les valeurs des elements Object et Array mais leur modification n'est pas autorisee. Les 
valeurs saisies peuvent etre des chames (delimitees par des guillemets), des valeurs numeriques ou des valeurs 
booleennes (true ou f al se). 



L'onglet Locales 

L'onglet Locales permet d'afficher les variables locales d'une fonction lorsqu'elle est analysee a 
l'aide des points d' arret. 
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Figure 3-32 

L'onglet Variables permet d'afficher et de 
modifier toutes les variables de V element 
selectionne dans la liste hierarchique. 
Dans notre exemple, le clip voiturel _mc 
est selectionne et on pent ainsi suivre 
1'evolution de toutes les valeurs des 
variables du clip ( exemple : la variable 
numero) et eventuellement les modifier. 
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Pile d'appel 



amch<Km(x) 
Button: :onPress() 



3 actions sur Sequence I: Image 1 du caique routes 



function afficheKm(x: Number) { 
var mesKm:String=x+"Km"; 
trace("la distance parcourue est "+ mesKm)- 



I voiture^mc.dvarlL'yjlM.UHMreijJsfunctionO { 
vojtUt>l 1 jate "-"^t||rfii™y -j-^ 



(tKJ ^ 
^^fficheKm(voiturel_mc._x)? 



Figure 3-33 

L'onglet Locales permet d'afficher et de modifier toutes les variables locales d'une fonction (parametres passes 
en argument). Pour afficher les valeurs des variables locales d'une fonction, ilfaut placer un point d 'arret au 
niveau de I'appel de la fonction afin de passer en mode pas a pas et d'afficher, ligne par ligne, 1'evolution des 
variables temporaires. 
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Longlet Observateur 

L'onglet Observateur pemiet de visualiser une selection de variables prealablement memorisees. II 
est ainsi possible de regrouper dans cet onglet des variables issues de plusieurs clips differents afin de 
suivre leur evolution sans avoir a selectionner a chaque fois dans la liste hierarchique le clip en 
rapport. Pour ajouter une variable de clip dans la fenetre de l'onglet Observateur, selectionnez le clip 
dans la liste hierarchique. Cliquez sur l'onglet Variables et selectionnez la variable desiree. Faites 
ensuite un clic droit et selectionnez 1' option Observateur dans le menu contextuel. La variable et sa 
valeur doivent ensuite etre visibles dans la fenetre de l'onglet Observateur (voir figure 3-34). 
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Clic droit sur la variable 











Figure 3-34 

L'onglet Observateur permet de centraliser les variables locales de differents elements dans un meme onglet. 
Pour surveiller revolution de variables depuis l'onglet Observateur, ilfaut les y ajouter au prealable. 

La pile d'appel 

La pile d'appel permet de visualiser les appels a des fonctions depuis un script. On peut ainsi voir la 
liste chronologique des differents appels successifs afin d'optimiser le programme, en reduisant si 
besoin est le nombre d'etapes necessaires a la realisation d'une tache specifique. 

La fenetre de code 

La fenetre de code du debogueur est semblable a l'editeur du panneau Actions. Pour visualiser un 
script dans cette fenetre, il faut d'abord selectionner 1' element auquel est rattache le script dans la 
liste deroulante situee en haut de la fenetre (voir figure 3-36). La fenetre affiche egalement automati- 
quement le script d'un element des qu'un point d'arret est rencontre. II est d'ailleurs possible de 
placer des points d'arret directement dans cette fenetre si vous ne l'aviez pas fait dans l'editeur du 
panneau Actions avant de lancer le mode Debogage. Pour placer un point d'arret, il suffit de cliquer 
dans la barre bleue a gauche en regard de la ligne sur laquelle vous desirez ajouter un point d'arret. 

La barre de commande des points d'arret 

La barre de commande regroupe des boutons qui permettent de controler les points d'arret. De 
gauche a droite, ces boutons ont pour fonction de demarrer ou de poursuivre le debogage (repere 1 de 
la figure 3-37), d'arreter le debogage (repere 2 de la figure 3-37), de supprimer ou de reactiver un 
point d'arret (repere 3 de la figure 3-37 ; dans ce cas il faut que le curseur soit sur la ligne du point 
d'arret concerne), de supprimer tous les points d'arret (repere 4 de la figure 3-37), de passer en mode 
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▼ Debogueur 

Tester I'animation :He:///C|/Program%20riles 



B SI J«v«IO.vo«ur«l_mc 

E] _l«w«IO.vottur«l_mcxiumerojKt 
B S J««K>.vollur«2_mc 

S] _level0.vortur«2_rricnurriero_txt 



Locales [obs*rv*t«ur] 



Nom 


|vil»ur 


A 


distance 


"61Km" 




E this 




y 


"6IKm" 





d'appel 




0& «-) (* 



actions wjr S«qutnc< 1 : Irrng« 1 du c*iqo« rout*s 



function afficheKm(x : Number) { 
var mesKm:String=x+"Km"; 
afficheOistance(mesKm); 
J 



afficheDistance(y : String 
var distance: String=y; 
trace("la distance parcourue e 



voiturel_mc.avance_btn.onPres«=function() { 
_T]iriire1 mni n— rnitiirrl rnrV-iv 



afficheKm(voiture l_mc ._x); 




nee) 



Figure 3-35 

La pile d'appel permet de surveiller I'enchainement des differents appels a des fonctions. Dans notre exemple, 
le script realise la mime action que dans V exemple de la figure 3-33, niais avec un appel supplementaire d une 
seconde fonction (ajoutee pour la demonstration). On pent ainsi detecter dans la pile d'appel que la seconde 
fonction est superfine et que les deux fonctions peuvent etre regroupees dans une seule et mime fonction, 
comme dans le script de la figure 3-33. 



^ X 



0& «>) (*> 



Q actions sur voitur«2_mc (voiture_mc) 



> X 



^ -actions sur avance_btn (avance_btn) 
HQ actions sur recule_btn (reculejMn) 
•] actions sur voiture_mc: Image 1 du caique Action 



I actions sur voilur«2_mc (¥oiture_mc) 



|E) action: sur voiture2_mc (voitur«_mc) 



1 onClipEvent (load) { 

2 var numero:String="2"; 

3 this._alpha=SO; 

4 } 



Figure 3-36 

Lafenetre de code permet d'afficher le code d'un element et de suivre revolution du pointeur de programme 
ligne par ligne en mode pas a pas. Pour afficher directement le script d'un element particulier de V animation, 
choisissez V element desire dans la liste du menu deroulant. 
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pas a pas principal (repere 5 de la figure 3-37 ; dans ce cas F execution du script est relancee jusqu'au 
prochain point d' arret), de passer en mode pas a pas detaille depuis un point d' arret (repere 6 de la 
figure 3-37 ; dans ce cas le script est execute ligne par ligne) ou de sortir du mode pas a pas (repere 7 
de la figure 3-37). 

1 2 3 4 5 6 7 

> X • * 

Figure 3-37 

La barre de commande permet de contrdler les points d' arret du debogueur. 
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L'editeur de code PHP 
de Dreamweaver 



Dans le chapitre consacre a l'environnement serveur, vous avez cree un petit script pour tester le 
fonctionnement du serveur (revoir le fichier bonjour.php dans le chapitre 2). Pour creer ce premier 
fichier PHP, vous avez utilise le Bloc-notes de votre PC (ou Simple Text si vous avez un Macintosh). 
Meme s'il est possible de creer tous vos scripts PHP de cette maniere, il est plus interessant d'utiliser 
un editeur plus evolue et surtout mieux adapte a la creation de scripts PHP (avec des fonctions de 
coloration syntaxique ou de memorisation de fragments de code, par exemple). II existe plusieurs 
editeurs specialises dans la redaction de programmes PHP, mais nous avons choisi de vous presenter 
l'editeur integre de Dreamweaver (Dreamweaver etant un produit Macromedia, son interface a un air 
de famille avec celle de Flash et vous etes certainement nombreux a en disposer si vous possedez la 
suite Studio 8). En matiere de performances et de fonctionnalites, Dreamweaver n'a rien a envier aux 
plates-formes de developpement de renom. Pour vous le prouver, nous allons faire un tour d' horizon 
des nombreux outils d' edition de code que Dreamweaver met a votre disposition. 

Definition d un site 

Avant de creer un fichier avec Dreamweaver, il est fortement recommande de definir la configuration 
du site. Nous allons configurer Dreamweaver avec le repertoire racine de Wamp 5 afin que nos 
fichiers Flash et PHP soient accessibles depuis le serveur Web Local. 

Depuis le menu, selectionnez Site puis Gerer les sites. Dans la fenetre Gerer les sites, cliquez sur le 
bouton Nouveau puis selectionnez Site (voir figure 4-2). La fenetre Definition d'un site s'affiche a 
l'ecran (voir figure 4-4). Pour definir un nouveau site, vous pouvez utiliser 1' assistant (onglet 
Elementaire) ou le mode Avance (onglet Avance). Cliquez sur l'onglet Avance car nous allons saisir 
nos parametres sans utiliser 1' assistant de configuration. 
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Ul.php (XHTMl )] 



Hctm Edbon Affichage Iraertwn Modher rente Comunde* Site FeneVe Aide 
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_jj Cre-Viwi Ttfe : 



I echo "bonjour, PHP fonctionne" 
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► ApokVKm 

► tnsoe<tew de babes 

TTTT^ 
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& C A ft JV -i ■ 
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K £3 3f>rogStructijree 
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v i_i 5-baseOonnees 

0 7-debogage 

1 > Connections 
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Figure 4-1 

L' interface de Dreamweaver 8 est composee d'une fenetre document ( repere 1) en haut de laquelle 

on trouve trois boutons ( repere 2 ) qui permettent de selectionner le mode ( mode Code, Fractionner 

ou mode Mixte et mode Creation ). Line barre d 'outils nommee Inserer ( repere 3 ) permet d 'acceder a plusieurs 

categories de boutons classes par themes a partir d'un menu deroulant. De nombreux panneaux disposes 

d droite et en bas de la fenetre de document permettent de parametrer les elements de la page ou d' acceder 

aux fonctionnalites de Vediteur. Le panneau Proprietes (repere 4) qffiche les caracteristiques de V element 

selectionne dans la page. Le panneau Fichiers ( repere 5) permet d'ouvrir les different s fichiers du site. 



Gerer les siles 




Figure 4-2 

Pour ouvrir un nouveau site, cliquez sur le bouton Nouveau puis selectionnez Site. 
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Informations locales 

La premiere categorie selectionnee affiche la page dediee aux informations locales (voir figure 4-4). 

• Le premier champ permet de renseigner le nom du site, soit SITEflash dans notre exemple. 

• Le second champ permet d'indiquer le chemin vers le repertoire dans lequel seront stockes les 
fichiers du site. Dans notre exemple, nous selectionnerons le chemin qui correspond au repertoire 
SITEf 1 ash deja cree lors de Finstallation de F infrastructure serveur (voir figure 4-3) : 

C : \wamp\www\SITEf 1 ash\ 



Choisissez le dossier racine local pour le site SITEflash : 



Sejectkmnei : 

[fa 

Mes documents 
recents 

Bureau 



Mes documents 



Q SITEflash 



Mes documents recents 
^ Bureau 
Q Mes documents 
j Poste de travail 
■^WindowsXP(C) 
j wamp 
^ www 



ftU3 
t3 Documents partages 
j '^i Mes documents 
Q| Documents de invite 
t3 Documents de jmdefrance 
^ Mes dossiers de partage 
*j Favoiis reseau 



9 

Poste de travail 

* L 

Favoris reseau Selectionner . SITEflash 



O tt C? E3- 



| Selectionner \ 
Amuler 



Figure 4-3 

Selection du repertoire SITEflash place dans la racine du serveur local www. 



En dessous de ces deux champs, d'autres options peuvent etre configurees (voir figure 4-4) : 

• Un dossier special permet de stocker les fichiers images (il est d'usage de separer les medias dans 
la structure d'un site Internet ; les fichiers HTML, images, sons, videos, etc., sont toujours enregistres 
dans des repertoires differents). 

• Un champ Adresse HTTP permet d'indiquer l'URL sous laquelle voire site sera consultable en ligne. 
Ainsi, Dreamweaver peut verifier la validite des hyperliens que vous avez integres dans le site. 

• Un champ Cache permet de memoriser les informations du site afin d'accelerer les differents trai- 
tements de l'editeur. Vous pouvez cocher cette option, mais elle sera surtout indispensable pour les 
sites de grande envergure. 
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Definition du site pour SITEflash 



Elementaire Avance 



Categorie 



Infos distantes 
Serveur devaluation 
Vollage 
Design Notes 

Mise en forme de la carte du site 
Colonnes en mode Fccraer 
Contribute 



Infos locales 




Norn du site : SITEflash 



Dossier racine local: C:\wamp\www\SITEflash\ 

0 Actualiser automatiquement 



Dossier des images par def aut : 




Liensrelabfsa: ©Un document O La racine du site 



Adresse HTTP : | http:// 



Cette adresse est utilisee pour les Kens 
relatif s au site, et pour permettre au 
Verificateur de kens de detecter les liens 
HTTP qui font reference a votre propre site 

Liens sensible a la casse : □ ytiliser verification des liens sensfcle a la casse 
Cache : 0 Activer le cache 

Le cache conserve les informations sur les 
fichiers et les actlfs du site, ce qui accelere 
les fonctiomalites du panneau des actif s, 
de la gestion des tens et de la carte du site. 



OK I Annuler Aide 



Figure 4-4 

La categorie Infos locales de la fenetre Definition du site permet de definir le nom du site et le dossier racine 
sous lequel seront stockes les fichiers du projet. 



Informations distantes 

Selectionnez ensuite la categorie Infos distantes dans le cadre de gauche (voir figure 4-5). Elle 
permet de transferer vos fichiers sur un serveur distant. Dans le cadre de cet ouvrage, vous utiliserez 
uniquement le serveur local precedemment installe avec Wamp 5 et vous n'aurez pas a utiliser de 
serveur distant. Cependant, nous detaillons la procedure de parametrage de cette categorie afin que 
vous puissiez par la suite transferer vos applications sur un serveur de production. 

Dans la partie de droite, selectionnez F option FTP dans le menu deroulant. Saisissez ensuite les para- 
metres de votre compte FTP dans les champs appropries de la fenetre. Les informations concernant 
l'hote FTP, le repertoire de l'hote, le nom de Futilisateur et le mot de passe doivent vous etre fournis 
par votre hebergeur (a titre d' illustration, vous trouverez dans le tableau 4-1 des exemples de parametres 
possibles pour un compte FTP). 

Au terme de votre saisie, vous pouvez verifier F exactitude de vos informations en cliquant sur le 
bouton Test. Cliquez ensuite sur OK puis sur le bouton Definition du site de la fenetre Modifier les 
sites pour confrrmer vos modifications. 
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Tableau 4-1. Description des parametres d'un compte FTP et exemples de configuration 
(ces parametres doivent vous etre communiques par votre hebergeur) 



Hote FTP 


Adresse Internet (nom ou IP) du serveur FTP 


ftp.monsite.com 






(ou 213.185.36.111) 


Repertoire 


Repertoire distant dans lequel vous devez telecharger vos 


/web/ 




fichiers. (champ optionnel chez certains hebergeurs) 


(ou /html ou encore /httpdocs/) 


Nom de I'utilisateur 


Nom du compte FTP 


Flash 



Mot de passe Mot de passe FTP 1234 



Definition du site pour SKHIdsh 



Elcmentalre Avence 



Ixemple de configuration 



Categorie 



voilage 

Design Nates 

Mise en forme de Is carte du ate 
Colonnes en mode Fitter 
Contribute 



Irrfos distantes 




Motdeoa* 



□ l 

□ Utikser un pore-feu | Parametres du pars-feu.. 

□ UrJser Secure FTP (SFIP) 



I C,uriiuaU)tte du serveur... 



0 Conserver les mf ormaoons de synchronisation 

□ Telecharger autom. les fichiers vers le serveur tors de renregistrement 

O Actiyer rarchtvage et Textr action de froSer 



Figure 4-5 

La categorie Infos distantes de lafenetre Definition du site permet de definir les diffe rents parametres 
pour la publication de votre site sur le serveur distant en FTP, 
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Dans la partie inferieure de la fenetre, d'autres options peuvent egalement etre configurees. Selon les 
particularites de votre connexion a Internet ou de votre pare-feu, vous pouvez utiliser F option FTP 
passif ou indiquer les parametres de votre pare-feu dans la fenetre Preferences de Dreamweaver (si 
votre reseau local est equipe d'un pare-feu). L' option SSH permet de vous connecter en mode secu- 
rise code si votre site distant a ete configure en consequence. En bas de la page, deux autres options 
peuvent etre activees. Telecharger automatiquement les fichiers sur le serveur permet de mettre auto- 
matiquement a jour vos fichiers sur le serveur distant lors de chaque enregistrement execute en local. 
Enfin, 1' option Activer Farchivage et F extraction de fichier vous permet de travailler en equipe sur le 
meme serveur distant. Dans ce cas, vous devez indiquer votre identifiant et votre e-mail dans les 
champs qui s'affichent lorsque vous validez cette option. 

Serveur devaluation 

Nous venons de configurer la connexion FTP et nous pourrions valider nos modifications et quitter la 
fenetre Definition du site. Cependant, nous vous suggerons de selectionner la categorie Serveur 
d'evaluation afin de decouvrir les options qu'elle contient. 

La page de la categorie Serveur d'evaluation regroupe les parametres destines a configurer le serveur 
de test afin de pouvoir utiliser les comportements serveur de Dreamweaver. lis permettent de generer 
automatiquement des scripts PHP en interaction avec une base de donnees. Dans le cadre de cet 
ouvrage, nous n'utiliserons pas les comportements serveur de Dreamweaver mais nous verrons plus 
tard que la configuration du serveur d'evaluation permet de disposer de certaines fonctionnalites 
dediees a MySQL qui faciliteront le developpement de vos futurs sites dynamiques. Vous pouvez 
vous reporter au chapitre 18 si vous desirez configurer cette categorie des maintenant. 

Editeur en mode Code 

L'editeur de Dreamweaver permet de travailler selon trois modes differents : mode Creation, mode 
Code ou mode Mixte. Nous allons nous interesser plus particulierement a F utilisation du mode Code 
et a ses fonctions, afin d'ecrire nos propres scripts PHP. 

Avant d' utiliser l'editeur, nous allons creer une nouvelle page PHP. Pour cela, cliquez dans le menu 
sur Fichier puis selectionnez Nouveau (ou utilisez le raccourci clavier Ctrl + N). Dans la fenetre 
Nouveau document, selectionnez Page dynamique dans la premiere colonne et PHP dans la seconde 
(voir figure 4-6) puis validez en cliquant sur le bouton Creer. 

Une fois le nouveau document cree, vous pouvez passer en mode Code en le selectionnant dans le 
menu Affichage>Code ou en cliquant sur le bouton Afficher le code situe a gauche de la barre d'outils 
document. 
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NouvcdU document 



General Modeles 
Categorie: 



Page dynamique : 



Apercu : 



'age dynamique 
Pagl 
Autre 

Feuilles de style en cascade (CSS) 
Jeux de cadres 
Conceptions de page (CSS) 
Pages d'accueil 
Conceptions de page 



ASP JavaScript 
ASP VBScript 
ASP.NET C# 
ASP.NET VB 
ColdFusion 

Composant ColdFusion 



< Aucun apet cu> 



Document PHP 



Type de document (DTD) : 



XHTML 1.0 iransilionnel 



[ Aide | | Preretences.T"! Obtenir du contenu supplementaire.. 



Creer | Annulet 



Figure 4-6 

Creation d'un nouveau document PHP 



Avant de saisir la premiere ligne de code, assurez-vous que toutes les options sont configurees correcte- 
ment. Pour cela, cliquez sur le bouton d' options a droite de la barre d'outils document (voir figure 4-7 ; si 
cette barre d'outils n'apparait pas, cliquez sur Affichage>Barre d'outils et cochez Document). 

Les differents choix du menu Option correspondent aux definitions des options suivantes : 

• Retour automatique a la ligne - renvoie le code a la ligne lorsqu'il excede la largeur de la fenetre 
de l'editeur. Nous vous conseillons de cocher cette option car elle rend la lecture plus confortable 
lors de la redaction des scripts. 

• Numero de ligne - permet la numerotation des lignes dans la fenetre document en mode Code ou 
dans l'inspecteur de code. Cette option est fort utile lors de vos premiers depannages de scripts, 
pour reperer la ligne signalee par le message d'erreur PHP. 

• Mettre en surbrillance le code HTML incorrect - pour eviter les erreurs de ce type, il est indis- 
pensable de respecter l'equilibre du code HTML (une balise d'ouverture doit toujours etre fermee) dans 
lequel vous emulerez des balises HTML a l'aide de scripts PHP (par exemple : echo "<TABLE>"). 
Cela permet notamment aux graphistes de pouvoir afficher coiTectement le document en mode 
Creation, meme apres l'ajout d'un script PHP dans la page. 
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9 Macromedia Dreamweaver 8 [Untitled ? (XHTML)*] 



Renter Edition Affichage Insertion Modfie- Texte Cornmandes Site Fen&re Aide 
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I <title>Docuaent sans titre</title> 
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£3 
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Q Date: 24/06/3I06 16: poT^aT"! 



Figure 4-7 

Le morfe Code de Dreamweaver permet de saisir vos scripts avec le meme confort qu 'avec un editeur 
dedie au developpement de code source. Pour faciliter votre saisie des fonctions PHP, nous vous conseillons 
d'utiliser le raccourci clavier Ctrl + Espace. De meme, le bouton d' options de la barre d'outils document active 
differentes fonctions de la fenetre document, tres appreciables pour une utilisation en mode Code. 



• Coloration de la syntaxe - la coloration syntaxique est tres utile pour la recherche de pannes et 
pour la saisie. Dreamweaver permet d'utiliser la coloration syntaxique du langage PHP et il serait 
dommage de s'en priver. II est possible de configurer chaque couleur selon le type de code repre- 
sente (voir figure 4-8 : pour acceder a cet ecran, affichez la fenetre Preferences, rubrique Colora- 
tion syntaxique et PHP, puis cliquez sur le bouton Modifier le modele de coloration). Pour une 
bonne lisibilite de votre code source, nous vous conseillons de conserver les couleurs attribuees par 
defaut. 

• Retrait auto - automatise la mise en retrait du code des que vous appuyez sur la touche Entree lors 
de la redaction du code. 
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Modifier le models de coloration pour PHP 



Categoric 

Genial 
AccessWrte 

Apercu dans le navigateur 
B-arre d'etat 



Copwr/Coler 
Correction du code 
Elements nvisibles 
Format de code 
Inckateurs de code 
Mode Mtte en forme 
Nouveau document 
Pokes 

Programme de vaWatwn 
SN 

Styles CSS 
SurbnBance 

Types de fichiers / Edrteurs 



Color abon du code 



Type de document : ASP JavaScript 
ASP VBScript 



ASP.NET C# 
ASP.NET VB 
ColdFusion 

Composant CokJFunon 
HTML 




enbere) 

AcbonScnpt 
AcbonScrjpt distant 
C# 

CornmuntcatMyis ActcnScrot * 
[ Mocftner le modete de coloration 



Arriere-plan par def aut [2 *FFFFFF 




Ubrary Items 

PHP gDJ c' BOQ ['rl 'i-fc 
PHP Scnpt Bracket 
PHP Scnpt Comment 
PHP Scnpt Constant! 
PHP Sent* Def «* Text 



PHP Scnpt Number 

PHP Script Operator 

PHP Scnpt Reserved Keyvror ds v 



Apercu: 



<?p»p 

»ysql_connect ((host, (user, (password) ; 
(result ■ ■ysql_db_ciuety ("database", "select 1 
while ((cow ■ aysql_Cetch_a330c ((result)) 

< 

echo (row["user_ld"]; 
echo (row["fullname"]; 



> 



Figure 4-8 

Depuis la fenetre Preferences, vous pouvez modifier les differentes couleurs de la « coloration syntaxique » de 
l'editeur de code. 



Outils de gestion de code 



Les outils de Dreamweaver 

Dreamweaver dispose de nombreux outils pour intervenir directement dans le code des pages Web. Certains sont 
bien adaptes a la gestion des balises HTML ou a I'insertion de balises PHP isolees. D'autres vous permettent 
d'enregistrer des fragments de code PHP afin de capitaliser vos developpements. Meme si plusieurs d'entre eux 
vous paraissent redondants, les connaTtre vous donnera la possibility de choisir I'outil adapte au contexte de votre 
intervention. 



Indicateur de code 

L' indicate ur de code vous guide dans la saisie de vos codes. Vous pouvez Futiliser depuis la fenetre 
du document en mode Code. Pour le configurer, ouvrez la fenetre Preferences, rubrique Indicateur de 
code (voir figure 4-9). Vous pouvez le desactiver ou augmenter son temps de reaction si vous le trou- 
vez trop envahissant. De meme, depuis cette fenetre, vous pouvez configurer la creation automatique 
de la balise de fin (cocher le bouton radio de Foption en rapport) ou reduire son action a certains types 
de codes (cochez les cases correspondant aux actions desirees : noms des balises, noms des attributs, 
valeurs des attributs, valeurs des fonctions...). 

L'indicateur de code est tres pratique des qu'on commence a bien savoir l'exploiter. II permet de 
saisir du code HTML ou PHP facilement et rapidement, sans avoir a se referer a la documentation. 
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tiinM 
Accessibility 

Apercu dans le navigateur 
Bar re d'etat 

Coloration du code 
Comparatson de Thiers 
Copier/CoRer 
Correction du code 
riArrtftfi'i bwkMM 



• rvicateurs de code 



Nouvcou document 
Pokes 

Programme de vafcdalton 
9a 

Styles CSS 
ijfbfiHoncc 

Types de tiLhiefs / Editeurs 



Indicateurs de code 



Balises de fermetur e : 0 Apres saisie de "</" 

O Apres sarsie de la Tin de la balise d'ouveiture ">" 
O^ai'iois 

Options : 0 Attrver les Indicateurs de tode 

tfU: f Oswundes 

0 5 



Menus : 



R Noms des balises 

0 Nnms rles flrtnhiirs 

PI vateurs des attnbuts 

0 Arguments des foncttons 

0 Methodes quant aux objets et variables 

0 tnWcsHIML 

0 Noms de propiietes CSS 

0 Outds Conseils de code 



Pour alouter ou supprinsr des ballses et attnbuts, utts« I'editeur de la 



Figure 4-9 

La fenetre Preferences, rubrique Indicateur de code, vous permet de configurer les differentes options 
disponibles pour V indicateur de code. 



Pour illustrer son fonctionnement, nous vous proposons de commenter son utilisation pour la creation 
d'une balise d'un tableau HTML, puis pour le parametrage des arguments d'une fonction PHP. 

• Creation d'une balise de tableau HTML avec l'indicateur de code (voir figure 4-10) - Depuis 
un editeur de code (fenetre mode Code ou inspecteur de code), saisissez le debut d'une balise de 
tableau, par exemple <t. L'indicateur apparait et vous propose les differentes balises HTML 
commen§ant par t (si la premiere lettre n'est pas suffisante pour afficher la bonne balise, saisissez 
une deuxieme lettre et ainsi de suite jusqu'a l'affichage correct de la balise desiree). Des que vous 
pouvez selectionner la balise desiree dans le menu deroulant, validez-la en appuyant sur la touche 
Entree. Le debut de la balise est complete automatiquement. Appuyez sur la touche Espace pour 
afficher de nouveau l'indicateur de code, cette fois en mode Attribut (notez qu'une petite icone 
precede chacun des attributs afin de vous rappeler le type de fonction auquel il appartient). De la 
meme maniere que pour les balises HTML, il suffit de valider l'attribut desire pour qu'il apparaisse 
dans le code. Cette fois, le pointeur de la souris est positionne entre les guillemets de la valeur de 
l'attribut. Si les valeurs attendues sont standards, un nouveau menu deroulant propose les choix 
possibles. Dans le cas contraire, saisissez la valeur (par exemple 1 pour l'attribut border). Ensuite, 
appuyez sur la touche du clavier Fin pour vous placer apres les guillemets, puis sur la touche 
Espace pour saisir un autre argument. Renouvelez la meme operation pour le deuxieme argument 
et terminez votre saisie par un caractere >, afin que l'inspecteur affiche automatiquement la balise 
de fermeture correspondante. 
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L'indicateur de code vous permet de saisir facilement vos balises HTML sans avoir a vous referer a la 
documentation. 



Creation d'une fonction PHP avec l'indicateur de code (voir figure 4-11) - L'indicateur de code 
peut aussi gerer les differentes fonctions PHP, ainsi que les variables HTTP (par exemple, si vous 
saisissez $, il vous propose les differents types de variables serveurs disponibles dans un menu 
deroulant : $ _ GET, $ _ POST...)- En guise d' illustration, voici la demarche a suivre arm 
d'exploiter pleinement les possibilites de cet outil pour declarer une constante insensible a la casse 
(nous utilisons pour cela la fonction def ine( ), avec comme troisieme argument la valeur 1, voir 
figure 4-11). Commencez par saisir le debut de la fonction dans une zone PHP de votre page (zone 
encadree par les balises <?php et ?>), soit « define( ». Une zone d'assistance s'affiche alors en 
dessous de la fonction et vous rappelle le type et le role des differents arguments attendus pour la 



Figure 4-1 1 

L'indicateur de code vous permet 
de connaitre les differents arguments 
attendus par les fonctions PHP. 



I define ( 



* siting name, mixed value, m( case_insensitive 



define ("CONSTANTE", 



mixed value, mt case insensitive 



de£ine( "CONSTANTE", "Bonjout", 



int case rtsensilive 



define ("CONSTANTE", "Bonjout",!); 
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fonction. Commencez la saisie en suivant ces indications (il est a noter que, des que la saisie du 
premier argument commence, la zone d' assistance disparait). Si vous ajoutez ensuite une virgule, 
la zone d' assistance apparait de nouveau et vous informe sur les arguments restants a saisir. 
Procedez de la meme maniere pour tous les arguments attendus et terminez votre saisie par une 
parenthese fermante. N'oubliez pas le point-virgule si vous etes a la fin de l'instruction. 

Fragment de code 

Les fragments de code permettent de stocker des parties de code preenregistrees afin de les reutiliser. 
Vous pouvez creer et inserer des fragments de code en HTML, JavaScript ou PHP. Dreamweaver 
contient egalement quelques fragments de code predefinis. Pour ouvrir la fenetre des fragments de code 
depuis le menu, selectionnez Fenetre>Fragments de code (ou a Faide du raccourci clavier Maj + F9). 

Le fragment de code peut soit envelopper une selection, soit se presenter comme un bloc de code. Vous 
pouvez par ailleurs assortir vos fragments de code de commentaires destines aux autres utilisateurs. 



A noter 

Les fragments de code se trouvent dans le sous-dossier Conf i gurati on\Sni ppets du dossier de I'application 
Dreamweaver 8. Vous pouvez facilement les copier pour les utiliser sur un autre poste ou pour les transmettre a 
d'autres developpeurs. 



Voici la procedure pour creer un fragment de code : 

1. Ouvrez la fenetre des Fragments de code (Maj + F9). Cliquez sur Ficone Nouveau dossier situee 
en bas du panneau Fragments de code et nommez ce dossier PHP. 

2. Cliquez sur Ficone Nouveau fragment de code situee en bas du meme panneau. 

3. La boite de dialogue Fragment de code s'affiche (voir figure 4-12). Saisissez un nom explicite 
pour votre futur fragment (exemple : Redirection PHP), puis decrivez Faction du code dans la 
zone Description. Selectionnez F option Envelopper la selection ou Inserer le bloc selon les 
besoins ; dans notre exemple, nous desirons envelopper la selection avec les deux blocs de code 
suivants : headert Locati on : " et " ) ; . Saisissez ensuite votre code dans la ou les fenetres destinees 
aux codes. Configurez enfin Foption Type d'apercu en selectionnant la valeur code en bas de la 
fenetre, puis cliquez sur OK. 

Voici la procedure pour inserer un fragment de code : 

1. Placez le point d' insertion a Fendroit du document qui vous convient (dans le cas d'un fragment 
d'un seul bloc) ou delimitez la selection a envelopper (dans le cas d'un code enveloppant 
compose de deux parties). 

2. Dans le panneau Fragments de code, double-cliquez sur le fragment de code desire (voir exemple 
figure 4-13). Vous pouvez egalement cliquer avec le bouton droit de la souris (Windows) ou en 
maintenant la touche Ctrl enfoncee (Macintosh) sur le fragment de code, puis choisir Inserer 
dans le menu contextuel. Vous devez ensuite ajouter le code dans Fediteur. 
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Fragment dc code 



Norn : 



De*ci<*ion : permet de red»»oer *jtom«tK*jement sur urw p*oe de<kee 



Inseret avaM: header ("Location: 



Typecfspercxj: O Creation ©Sods 



Figure 4-12 

Lafenetre de creation d'un nouveau fragment permet de saisir le code soit en un seul bloc, soit dissocie en deux 
parties afin d'envelopper le texte selectionne, comme ici. 




Afflchage de Vous ave! modfle le code, 

code Pour modfar les propnetes de selection, dquez scr 

ActvMfev ou F5 



► ResdMcs 




Figure 4-13 

Pour inserer un fragment de code, ilfaut au prealable selectionner le code a envelopper par le fragment 
(dans le cas d'un fragment en deux blocs), puisfaire un double-clic sur le fragment de code desire. 



Environnement de developpement 

Parte I 



Voici enfin la procedure pour modifier ou supprimer un fragment de code : 

1 . Selectionnez le fragment de code a modifier ou supprimer. 

2. Cliquez sur l'icone Modifier le fragment de code ou Supprimer situee en bas du panneau Fragments 
de code (voir figure 4-14) selon Taction desiree. 

(alalBrtttl 

Figure 4-14 

Les icones situees en bas de lafenetre Fragments de code vous permettent d'ajouter, de modifier ou de supprimer 
un fragment. 



La barre d'outils Inserer, option PHP 

L' option PHP de la barre d'outils Inserer permet d'ajouter rapidement des balises PHP dans la fenetre 
document en mode Code (voir figure 4-15). Pour que l'onglet PHP apparaisse, il faut se trouver dans 
une page dynamique PHP (menu Fichier>Nouveau>General>Page dynamique + PHP). Hormis le 
bouton d' insertion de commentaire, les differents boutons du panneau inserent des balises PHP de 
debut et de fin (<?php et ?>). Ce panneau est destine a inserer du code PHP isole dans le code source 
d'une page HTML et non a vous assister dans l'edition d'un script PHP de plusieurs instructions. 
Le bouton situe a 1' extreme droite du panneau permet d'appeler le selecteur de balises que nous 
detaillerons ci-dessous. Ainsi, vous pouvez acceder a d'autres balises PHP, mais aussi a toutes les 
balises HTML proposees en standard par Dreamweaver. Les fonctions des boutons de l'onglet PHP 
sont les suivantes : 

• Ajout de variables de formulaires : <?php $_P0ST[]; ?> 

• Ajout de variables d'URL : <?php $_GET[]; ?> 

• Ajout de variables de sessions : <?php $_SESSI0N[] ; ?> 

• Ajout de variables de cookies : <?php $_C00KIE[]; ?> 

• Ajout de la fonction Incl ure : <?php includeO; ?> 



d Macromedia Dreamweaver B [Untitled 3 (XHTML)*] 
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Figure 4-15 

L 'option PHP de la barre d'outils Inserer permet d'ajouter rapidement un code accompagne de ses balises PHP. 
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• Ajout de la fonction Necessite : <?php requlreO; ?> 

• Ajout d'un bloc de code PHP : <?php ?> 

• Ajout de la fonction Echo (affichage) : <?php echo ?> 

• Ajout d'un commentaire dans le code : /* */ 

• Ajout de la fonction If (test d'une condition) : <?php if ?> 

• Ajout de la fonction Else (complementaire de la fonction If) : <?php else ?> 

• Ajout d'une balise par le biais du selecteur de balise. 

Les references PHP de poche 

Pour ouvrir le panneau des references, utilisez le raccourci clavier Maj + Fl ou ouvrez le panneau 
Resultats (situe par defaut en dessous du panneau Proprietes) puis cliquez sur l'onglet Reference. Par 
le biais de ce panneau Reference, Dreamweaver met a votre disposition un dictionnaire de poche 
regroupant toutes les syntaxes des fonctions PHP. Dans le haut du panneau, selectionnez O'REILLY 
- Reference PHP de poche dans le premier menu deroulant Livre puis la famille de fonction que vous 
desirez consulter dans le deuxieme menu deroulant (voir figure 4-16) et enfin la fonction dans le troi- 
sieme menu deroulant. N'hesitez pas a consulter frequemment ces informations si vous avez un doute 
sur la syntaxe d'une fonction. 



Figure 4-16 

Le panneau Code onglet Reference permet de consulter un mini-dictionnaire de toutes les fonctions PHP. 

Les references du langage SQL 

Dans le meme panneau Resultats, onglet Reference, Dreamweaver met a votre disposition un second 
dictionnaire dedie au langage SQL (voir figure 4-17). Vous pourrez ainsi vous assurer de la validite 
de la syntaxe de vos requetes SQL avant de les integrer dans vos scripts PHP. Le chapitre 17 presente 
en detail les requetes et les clauses SQL couramment utilisees. 

Pour acceder a ce dictionnaire, vous devez au prealable ouvrir le panneau Resultat et cliquer sur 
l'onglet Reference (ou a l'aide du raccourci clavier Maj + Fl). Dans le haut du panneau, selectionnez 
O'REILLY - Reference du langage SQL dans le premier menu deroulant Livre puis la rubrique que 
vous desirez consulter dans le deuxieme menu deroulant (selectionnez, par exemple, la rubrique 
Reference des commandes) et enfin la sous-rubrique dans le troisieme menu deroulant (dans notre 
exemple, ce troisieme menu affiche une liste de commandes parmi lesquelles nous selectionnons SELECT). 



► Proprietes 



*R6«iUa(s Rechercher Reference Vatdarjon ViW rVarinn rtinavrat Wrfirurn . rle len Rapports du i»e Journal FTP 





count 

iM count [Mixed VWf« »od«]) 

Compte I* nombit d'«l*m«nts d'un* vtrUbl* (habituellement un tableau) 



Environnement de developpement 

Partie I 



► ftoprietes 








, JujJx JUliMLfJP Wbogage du set veur 




Livrs '^^EILLV - Reference du langage SQt^^J \5QL! Reference des commandeT^ySELECT 










aaaaaaaaaaaaaaaaaaaaaaaaaaaaaalaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaal WKU^^f^^^^KKKKKKKK^KtKKKKKKKKKKM 


.-Ji 


L 'instruction SELECT recupere das lign«s, d«s colonnes et d«s valeurs dinged 'un* ou plusieur? del tables d une base d« donnees. 




Editeur [ Command* 






SQL Server [Prise en charge, avec des variations (prise en charge des jointures ANSI) 






MySQL |prise en charge, avec des variations (prise en charge partielle des jointures ANSI) 






[Oracle (Prise en charge, avec des variations (pas de prise en charge des jointures ANSI) 






PostgreSQL [Prise en charge, avec des variations (prise en charge partielle des jointures ANSI) 






Svntaxe SOLSS- et description 






La syntaxe complete de 1 "instruction SELECT allie puissance et complexity, mais vous pouvez la decomposer en plusieurs dauses prlncipe 




SELECT [ALL 1 DISTTJICTJ select_list 

FROM taMenamel (,..., table_neaeH] 

[JOIN join_condition] 

[WHERE search_condition] 

[GROUP BY cjcoup_by_expre33ion] 

[HAVIHC search_condition] 

[ORDER BY ordec_exptesslon [ASC 1 DESC] ] 






Chacune des clauses de ('instruction SELECT possede une action specifique. II est done possibl 


a de parler individuellement de la clause F v 





Figure 4-17 

Le panneau Resultats onglet Reference permet de consulter un mini-dictionnaire de toutes lesfonctions 
et commandes SQL. 

Creation et test d un fichier PHP 

Nous venons de presenter les differentes fonctionnalites de Fediteur Dreamweaver. Pour clore ce 
chapitre, nous vous proposons maintenant de creer puis de tester un premier fichier PHP avec Dream- 
weaver. Vous aurez l'occasion de mettre en pratique cette procedure a maintes reprises dans le reste 
de cet ouvrage et nous vous invitons a noter les raccourcis clavier utilises car ils vous feront gagner 
un temps precieux dans vos futurs developpements. 

Creation d'un document PHP 

Avant de creer un document, vous devez selectionner le site dans lequel celui-ci sera integre. Dans 
notre exemple, nous utiliserons le site nomme SITEf 1 ash que nous avons configure precedemment (si 
vous n'avez pas encore configure le site SITEf 1 ash, reportez-vous a la section precedente qui detaille 
la procedure de definition d'un site). 

Le document que nous allons creer devra afficher une page phpinfo. Cette page utilisera la fonction 
phpinfoO pour afficher a l'ecran toutes les informations utiles sur la version et la configuration du 
PHP installe sur votre serveur. 

Cliquez depuis le menu sur Fichier puis Nouveau (ou utilisez le raccourci clavier Ctrl + N). Dans la 
fenetre Nouveau document (onglet General), selectionnez Page dynamique dans la colonne Cate- 
gorie puis PHP dans la colonne Page dynamique et cliquez sur le bouton Creer pour valider vos choix 
(voir figure 4-19). Un nouveau document encore indefini s'ouvre dans la fenetre centrale de l'editeur 
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A noter 

Une page phpinfo est deja disponible sur votre serveur local par I'intermediaire de la suite Wamp 5 (depuis le menu 
du manager de Wamp 5, selectionnez Localhost puis cliquez sur le lien phpi nfo() dans la rubrique Outils de cette 
page, voir figure 4-18).Cependant, la page que nousallons creer vous sera certainement utile si vous possedez un 
hebergement car elle vous permettra de connaitre les caracteristiques du PHP installe sur votre serveur distant. 
Nous rappelons a ce sujet qu'il convient de choisir un serveur de developpement local dont les caracteristiques 
sont proches de celles de votre serveur distant (evidemment, si vous n'avez pas encore choisi votre hebergeur, 
I'inverse est aussi valable...). 
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Figure 4-18 

Page phpinfo disponible depuis la page localhost de Wamp 5 



(fenetre document). Enregistrez tout de suite votre document sous le nom phpinfo. php dans la racine 
de SITEf 1 ash (voir figure 4-20). A la racine de SITEflash, vous devez retrouver le fichier bon jour. php 
cree lors du test de F infrastructure serveur. Les autres repertoires presents a cet endroit (voir figure 4-20) 
sont destines a recevoir les futurs fichiers correspondant a chaque chapitre de cet ouvrage. Si vous 
desirez creer des maintenant ces repertoires, vous pouvez le faire depuis la fenetre Enregistrer sous 
en cliquant sur le bouton Creer un nouveau dossier. 
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Nouveau document 



General Modetes 
Calegoiie 



'age dynamique^ 
Pagl 
Autre 

Feuies de style en cascade (CSS) 
Jeux de cadres 
Conceptions de page (CSS) 
Pages d'accuerl 
Conceptions de page 



Page dynamique 



Apercu 



H ASP JavaScript 

£ ASP VBScript 

■ ASP.NEI C# 

SL ASP. NET VB 

y ColdFusion 

Bjj Composant ColdFusion 



<Aucun apetcu> 



Description : 
Document PHP 
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Figure 4-19 

La f entire document permet de choisir le type de document a ouvrir. 
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Figure 4-20 

Notre fichier phpinfo.php est enregistre dans la racine de SITEflash. 
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Assurez-vous que vous etes bien en mode Code (si besoin, cliquez sur le bouton Code place en haut a 
gauche de la fenetre document). Dans la barre des outils, deroulez la liste et selectionnez Foption PHP 
(voir figure 4-21). Placez votre pointeur entre les balises <body> et </body> puis cliquez sur le bouton 
Bloc de code (voir figure 4-22) afin d'ajouter automatiquement les balises ouvrante et fermante d'un 
script PHP (<?php et ?>). Ajoutez ensuite entre ces deux balises 1' instruction suivante : phpinfo( ) ; 
(voir figure 4-23) puis enregistrez votre fichier en utilisant le raccourci clavier Ctrl + S. 



Figure 4-21 

Pour changer de barre d'outils, 

il suffit de derouler le menu 

de selection place a gauche 

de la barre d'outils. 

Ici, nous selectionnons la barre 

PHP. 
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Figure 4-22 

Le bouton Bloc de code de la barre d'outils PHP permet d'ajouter automatiquement les balises PHP 
dans la fenetre document. 



Figure 4-23 

L' instruction phpinfo(); doit etre 
inseree entre les deux balises PHP afin 
d'etre interpretee par le module PHP. 



<body> 

<?php phpinf o ( ) ; ?> 

|c/body> 

</html> 
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Test d'un document PHP 

Contrairement a un fichier HTML pour lequel il suffit d'ouvrir un navigateur pour le tester, un docu- 
ment PHP doit obligatoirement etre appele depuis le serveur Web local de Wamp 5 arm que l'inter- 
preteur PHP du serveur puisse executer les instructions incluses dans le document. 

Pour appeler un document depuis le serveur local, cliquez avec le bouton droit sur l'icone EasyPHP 
et selectionnez Foption Web Local. La fenetre qui s'ouvre (voir figure 4-24) affiche les repertoires 
des sites presents a la racine du serveur local (dans notre exemple, il n'y a qu'un seul dossier nomme 
SITEf 1 ash). Cliquez sur le dossier SITEf 1 ash puis sur le fichier phpinfo.php. Le fichier que nous 
venons de creer est alors demande au serveur. Son extension etant .php, le fichier est oriente vers le 
preprocesseur PHP du serveur qui analyse le contenu a la recherche de balises PHP ( <?php ... ?>). Des 
que le preprocesseur trouve une balise PHP, il interprete son contenu et renvoie le resultat (au format 
HTML) en lieu et place de la precedente balise PHP. Ainsi dans notre exemple, F interpretation de 
l'instruction phpinfoO renvoie un tableau HTML contenant toutes les caracteristiques du module 
PHP installe sur le serveur (voir figure 4-25). 
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Figure 4-24 

La page d'index placee a la racine du serveur (repertoire www) presente les differents dossiers de sites places 



a ce niveau. 
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Figure 4-25 

La page phpinfo.php affiche dans une seule page HTML toutes les caracteristiques du module PHP du serveur. 



Raccourcis clavier pour la mise au point d'un document PHP 

Theoriquement, la barre des taches de votre ordinateur (zone situee au centre et en bas de l'ecran du 
PC) affiche deux boutons. L'un correspond a l'editeur Dreamweaver et l'autre au navigateur qui affi- 
che la page phpinfo.php (voir figure 4-26). Pour passer d'une fenetre a l'autre, il suffit de cliquer sur 
le bouton correspondant a la page desiree, mais il est beaucoup plus rapide d'utiliser le raccourci 
clavier Alt + Tab. 

Imaginons maintenant que le resultat de la page que nous venons de creer ne vous convienne pas. II 
vous faut alors basculer de nouveau dans l'editeur (en utilisant evidemment le raccourci clavier 
Alt + Tab) afin de modifier le contenu du code source de la page PHP. Pour illustrer cette demarche, 
nous allons ajouter le titre PHPINFO a la page (voir figure 4-26). Une fois la modification effectuee, 
enregistrez votre page (en utilisant le raccourci clavier Ctrl + S) puis basculez dans le navigateur 
(Al t + Tab) afin de voir le resultat. Une fois dans le navigateur, vous devrez actualiser la page a l'aide 
du raccourci F5 (ou en cliquant sur le bouton Actualiser de votre navigateur) pour voir apparaitre 
l'ecran modifie. 
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Figure 4-26 

Lora rfe /a mise au point d'un programme, vous aurez besoin de basculer de I 'editeur Dreamweaver au 
navigateur de multiples fois. Pour cefaire, vous pouvez cliquer sur les boutons places en bas de Vecran mais 
il est beaucoup plus rapide d'utiliser le raccourci clavier Alt + Tab. 



En phase de developpement, vous devrez tres souvent effectuer les manipulations que nous venons 
d'indiquer. Nous vous suggerons de privilegier l'emploi des raccourcis clavier afin de gagner du 
temps (voir figure 4-27). 

Par la suite, vous serez amene a mettre au point simultanement des documents PHP et AS et vous 
devrez par consequent tester le bon fonctionnement des interactions entre ces deux types de 
programme. Dans ce cas, trois applications devront etre ouvertes en meme temps, l'editeur Dream- 
weaver pour 1' edition des programmes PHP, Le navigateur destine a controler le fonctionnement du 
projet depuis le Web Local et l'editeur Flash pour F edition des codes ActionScript. 

Pour tester l'interfacage entre le document PHP et F animation Flash, la demarche precedente devra 
etre completee comme l'indique la figure 4-28. 



A noter 

Pour exploiter les raccourcis clavier de la figure 4-28, il faut avoir lance les trois applications dans I'ordre suivant : 
Dreamweaver, Web Local et Flash. 
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Figure 4-27 

Enchatnement des differents raccourcis clavier utilises en phase de developpement. 



Procedure de mise au point d'interaction 
entre un document PHP et Flash 
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Figure 4-28 

Les differents raccourcis clavier utilises en phase de developpement afin de tester V interaction entre 
un document PHP et une animation Flash. 
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Introduction a la programmation 



Avant de vous presenter les premieres bases de PHP et ActionScript, nous vous proposons un petit 
rappel des concepts indispensables a l'apprentissage d'un langage de programmation. 

Notion et definition de la variable 

Si la notion de variable parait evidente aux programmeurs inities, il n'en est pas de meme pour les 
debutants. Pourtant, cette notion est fondamentale en programmation, car c'est la variable qui 
contient 1' information traitee par le programme. En outre, il est difficile d'apprehender d'autres 
concepts tels que l'affectation ou le typage si Ton n'a pas bien compris celui de la variable. 

En informatique, une variable est une etiquette qui sert a identifier un emplacement specifique de la 
memoire de Fordinateur (voir figure 5-1). Si la variable n'existait pas, le programmeur devrait identifie 



MEMOIRE DE L'ORDINATEUR 



PROGRAMME 
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^ I mdmoire 
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VARIABLE : Etiquette representant {'emplacement memoire 



Figure 5-1 

Sy steme d'adressage d'un emplacement memoire 
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l'emplacement de la memoire dans lequel il desire stacker une information en utilisant l'adresse 
numerique de ce dernier. La variable lui permet done de se detacher de ces contraintes technologiques 
en utilisant une etiquette correspondant a l'adresse numerique sans se soucier de Forganisation physique 
de la memoire. 



Definition d'une variable 

Une variable est un objet repere par son nom, contenant des valeurs pouvant etre modifiees lors de I'execution du 
programme. 



La metaphore de la boTte 

Pour illustrer le concept de la variable, imaginez des boites dans lesquelles nous aurions insere des 
ardoises. La boite represente la variable (done l'adresse de l'emplacement memoire) et l'ardoise le 
support de la valeur (done l'emplacement memoire lui-meme). Pour identifier facilement les 
nombreuses boites, une etiquette personnalisee est appliquee sur chacune d'elles (voir figure 5-2). 
Enfin, comme vous l'avez certainement devine, F etiquette apposee sur les boites correspond au nom 
de la variable. 



Limites de la metaphore 

Les principes de fonctionnement de notre systeme de boites n'ont pas tous un equivalent parmi les concepts 
abstraits de la variable. Nous vous conseillons done d'exploiter les ditferentes similitudes que nous avons rassem- 
blees dans ce chapitre avec une grande prudence et de ne pas extrapoler d'autres concepts. 




Figure 5-2 

Metaphore de la boite 
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Concept de la declaration d'une variable 

Dans notre metaphore, le simple fait d'ajouter une boite permet de preparer une nouvelle ardoise afin 
de memoriser son information (voir figure 5-3). En programmation, l'ajout d'une nouvelle boite 
correspond au concept de la declaration d'une variable. Ainsi, des qu'une variable est declaree, un 
espace memoire (dont la faille depend du type de la variable ; voir le concept de typage de la variable 
ci-apres) est reserve afin d'accueillir sa future valeur. Tant que la variable n'a pas ete affectee, l'espace 
memoire reserve est vide (Empty). 




En pratique, la declaration d'une variable est souvent associee a l'instruction de typage (voir le concept 
de typage d'une variable ci-apres) ou effectuee automatiquement lors de sa premiere affectation (voir 
le concept de F affectation ci-apres). 

A noter 

Dans certains langages, les noms des variables doivent etre precedes par convention d'un signe caracteristique. 
C'est le cas notamment de PHP, dans lequel chaque nom de variable doit commencer par le signe $ (exemple : $A). 



Concept du typage d'une variable 

Imaginez maintenant qu'il existe plusieurs families de boites caracterisees par des formes differentes 
(rondes, triangulaires, carrees...). Chaque famille de boite ne pouvant contenir qu'une information 
de meme forme, il est evident qu'une information ronde (a faille egale) ne pourra pas etre inseree 
dans une boite triangulaire (voir figure 5-4). En programmation, cela correspond au concept de 
typage des variables. Evidemment, dans ce cas, il ne s'agit plus de formes de boite mais de types de 
variable differents (entier, chaine de caracteres, date...). Si Ton attribue un type particulier a une 
variable, il faudra ensuite lui affecter des valeurs de meme type. 



A noter 

En pratique, le typage d'une variable peut etre realise automatiquement lors de la premiere affectation (par exem- 
ple en PHP ou AS 1 ; dans ce cas, le type de la variable est celui de la valeur affectee) ou d'une maniere explicite 
a I'aide de mots-cles lors de sa declaration. 
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Par exemple, si vous utilisez le typage strict en ActionScript 2.0, le typage d'une variable A associe a sa declaration 
pourra etre realise avec I'instruction AS 2 suivante : 
var ArNumber. 

D'autre part, des langages de programmation « faiblement types », comme le PHP, autorisent I'affectation d'une 
variable meme si le type de la valeur ne correspond pas a celui de la variable. Cependant, cette souplesse va 
souvent a I'encontre de la fiabilite des programmes et elle est souvent a I'origine de nombreuses erreurs. II est 
done conseille de toujours respecter le typage d'une variable, meme si le langage utilise ne I'impose pas. 



Valeurs de 




Figure 5-4 

Concept du typage d'une variable 

Concept de la lecture d'une variable 

Si nous reprenons nos boites, il est interessant de remarquer que meme si elles sont nombreuses, il est 
toujours facile d'acceder a une information particuliere a partir de F etiquette de sa boite. Ainsi, pour 
consulter l'information d'une boite specifique, il faut la localiser en se referant a l'etiquette de sa 
boite, puis ouvrir celle-ci pour lire l'information inscrite sur l'ardoise (voir figure 5-5). En program- 
mation, une procedure similaire, appelee « lecture d'une variable », renvoie la valeur correspondant a 
la variable. 



A noter 

En pratique, chaque fois que vous utilisez le nom d'une variable dans une expression comme A = B + 5 (ou 
$A = $B + 5 en PHP), vous faites appel a la procedure de lecture d'une variable. Lors du traitement de I'expres- 
sion, la variable est remplacee par sa valeur. Ainsi, dans I'exemple precedent, si la valeur de B est egale a 2, 
I'expression traitee est equivalente a A = 2 + 5 (ou $A = 2 + 5 en PHP). 
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Concept de I'affectation par une valeur 

Si vous desirez ecrire ou modifier une information sur l'ardoise, la demarche est identique a celle de 
la lecture. II faut localiser l'ardoise a l'aide de l'etiquette de sa boite pour ensuite la sortir et inscrire 
(ou modifier) Finformation (voir figure 5-6). En programmation, la procedure correspondante s'appelle 
I'affectation. Elle consiste simplement a placer une valeur dans une variable. 



A noter 

Si I'affectation est realisee en meme temps que la declaration (ou juste apres), on parle de I'initialisation de la 
variable. 
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A noter 

En pratique, le signe « = » est souvent utilise pour signifier une affectation. Par exemple, pour affecter la valeur 6 a 
la variable A, vous utiliserez la syntaxe suivante : B = 6 (ou $B = 6 en PHP). 



Concept de I'affectation par une autre variable 

Pour copier une information d'une ardoise sur une autre, il faut commencer par une procedure de 
lecture, memoriser F information puis enchainer avec une procedure d' affectation correspondant a 
Fecriture de Finformation memorisee (voir figure 5-7). En programmation, la valeur a placer dans 
une variable peut provenir directement d'une autre variable. On parle alors d' affectation directe 
variable a variable. Dans ce cas, il est important de comprendre que le concept est similaire a celui de 
la metaphore et que la valeur est copiee et non transferee. D' autre part, des que la copie est effectuee, 
les variables ne sont plus liees et peuvent evoluer indifferemment Fune de Fautre (contrairement a ce 
qui se passe dans I'affectation par reference que nous allons presenter ci-apres). 




Figure 5-7 

Concept de I'affectation par une autre variable 
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A noter 

En pratique, de nombreux langages de programmation utilisent le signe « = » (A = B) pour signifier une affectation, 
mais malgre sa simplicity, I'utilisation de ce signe peut prefer a confusion. La premiere ambiguite est liee au fait 
qu'il ne fait pas apparaitre le sens de I'affectation (la variable A est-elle affectee a B ou I'inverse ?). Pour lever cette 
ambiguite, sachez qu'en programmation, les affectations se font toujours de la droite vers la gauche (dans I'exem- 
ple precedent, c'est done la valeur de la variable B qui est affectee a la variable A). D'autre part, si vous incremen- 
tez votre variable avec I'instruction A = A + 1 (ou $A = $A + 1 en PHP), I'egalite mathematique n'est pas 
respectee. II est done important de se rappeler qu'en programmation, le signe « = » est un symbole utilise pour 
signifier une affectation de la droite vers la gauche mais en aucun cas le signe de I'egalite mathematique. 



Concept de I'affectation par reference 

Imaginez que nous attachions deux etiquettes differentes a une meme boite. Dans ce cas, on peut acceder 
a la meme information par deux moyens differents. Si nous modifions 1'information de Fardoise en 
utilisant la premiere etiquette et accedons ensuite a cette meme ardoise par la seconde etiquette, 
1'information lue sera celle qui a ete precedemment ecrite (voir figure 5-8). En programmation, il 
existe une procedure d' affectation particuliere d'une variable a une autre variable dont le concept est 
similaire a Faction de coller une seconde etiquette sur une boite. Cette action s'appelle F affectation 
par reference et correspond en quelque sorte a la creation d'un alias de la variable et non a une simple 
copie de sa valeur dans une nouvelle variable. Apres une telle affectation, les deux variables sont 
liees, meme si elles portent des noms differents. La modification de Fune d'entre elles aura automa- 
tiquement une incidence sur la valeur de F autre (contrairement au principe de F affection classique 
d'une variable par une autre variable presente ci-dessus). 




Les etiquettes B ou D permettent 
d'acceder a la meme information 



Figure 5-8 

Concept de I 'affectation par reference 
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A noter 

En pratique, la syntaxe d'une affectation par reference est differente de celle d'une affectation classique. En PHP, 
par exemple, il faut faire preceder le nom de la variable par le caractere & comme dans I'exemple suivant : 
$D = &$B (le nom d'une variable PHP etant toujours precede par convention d'un caractere $). 



Concept de la variable de variable 

Avec notre systeme de boites, le nom d'une etiquette peut etre lui-meme memorise comme une infor- 
mation classique sur l'ardoise d'une seconde boite (voir figure 5-9). Dans ce cas, il faut lire la 
seconde boite et recuperer le nom de l'etiquette de la premiere pour pouvoir acceder a l'information 
finale. En programmation, ce fonctionnement correspond a celui du concept de la variable de varia- 
ble. En effet, il est quelquefois interessant d'utiliser un nom de variable dynamique arm de pouvoir 
appliquer un meme traitement a une serie de variables sans avoir a dupliquer des traitements person- 
nalises pour chaque nom de variable de la serie. 




Figure 5-9 

Concept de la variable de variable 



A noter 

En pratique, la syntaxe d'une variable de variable est differente de celle d'une variable classique. En PHP, par 
exemple, il faut faire preceder le nom de la variable par un second caractere $ comme dans I'exemple suivant : 
$$B = 6 (le nom d'une variable PHP etant toujours precede par convention d'un caractere $). 
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Concept d'un tableau de variables 

Avec notre systeme de boites, nous desirons maintenant memoriser les notes des eleves d'une meme 
classe. Plutot que d'utiliser des boites individuelles pour chaque note, nous allons creer une boite 
particuliere avec plusieurs compartiments contenant chacun sa propre ardoise. Ainsi, les notes de la 
classe seront regroupees dans une seule boite identifiee par une etiquette commune tout en conservant la 
possibilite de modifier individuellement les notes de chaque eleve (voir figure 5-10). En programma- 
tion, cela correspond au concept du tableau de variables. Les tableaux de variables permettent de 
regrouper une « collection » de valeurs ayant un lien entre elles dans une meme variable portant le 
nom de la collection. lis sont frequemment utilises pour appliquer rapidement un meme traitement a 
tous les elements d'une collection de valeurs. 



En pratique, on accede individuellement a chaque element d'un tableau en utilisant une cle placee entre crochets 
apres le nom de la variable. Pour reprendre notre exemple, NOTES [jean] et NOTES [pi erre] (ou $N0TES[jean] 
et $N0TES[pi erre] en PHP) correspondent aux notes de Jean et de Pierre et peuvent par exemple etre affectes 
de la valeur 18 et 14. 



Figure 5-10 

Concept d'un tableau de variables 

Concept de la constante 

Toujours avec notre systeme de boites, imaginez qu'une information soit inscrite sur F ardoise avec 
un stylo indelebile ! Evidemment, toute modification devient impossible mais la boite pourra cependant 
toujours etre utilisee en lecture (voir figure 5-11). En programmation, cela correspond au concept de 
la constante. Une constante est une variable particuliere dont la valeur n'est pas modifiable pendant 



A noter 
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F execution du programme. Elle permet notamment de declarer des parametres communs a un ensem- 
ble de programmes en ayant la certitude que leur valeur ne sera pas modifiee par erreur. 



A noter 

II existe de nombreuses constantes systeme (definies par defaut par le programme) qui permettent d'acceder a 
une valeur specifique par le biais d'un nom mnemotechnique (par exemple, le code des touches en AS : SPACE, 
TAB...). 




A noter 

En pratique, les noms des constantes sont souvent en majuscules. Elles peuvent etre predefines (comme les 
constantes systeme) et ne necessitent pas d'etre declarees ou definies par le programmeur en debut de 
programme. Par exemple, en PHP I'instruction suivante : define(M0NREPERT0IRE,'7chezmoi/") permet de 
declarer une constante MONREPERTOIRE qui seratoujours egale a la valeur /chezmoi/. 
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La syntaxe de PHP 
Extension de fichier PHP 

Comme nous Favons explique dans le chapitre 1, le code PHP doit etre interprete avant d'etre envoye 
vers le navigateur du client. Pour cela, le code source d'un script est toujours enregistre dans un fichier 
portant l'extension .php, pour que l'interpreteur PHP 1'identifie et Fanalyse (exemple : mapage.php). 

Balises de code PHP 

Le script integre dans la page doit en outre etre encadre par deux balises <?php et ?>, afin que l'inter- 
preteur PHP puisse evaluer le code ainsi delimite. (Dans cet ouvrage, nous utiliserons toujours ces 
deux balises, mais sachez qu'il existe d'autres manieres de les ecrire, voir tableau 6-1). 



Tableau 6-1 . 


Les differents types de balises acceptees par PHP 


Balise de debut 


Balise de fin 


<?php ?> 


<? ?> 


<script 1 anguage="php"> 


</script> 


<% 


%> 



Lorsque l'interpreteur PHP detecte la balise de debut (<?php), il traite le code qui suit comme des 
instructions PHP et les interprete jusqu' a ce que la balise de fin (?>) soit rencontree. Apres celle-ci, il 
considere que le code est en HTML et l'envoie tel quel au navigateur du destinataire. 
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Voici un premier script PHP : 
<?php 

echo "Bonjour"; 
?> 

Dans Fexemple ci-dessus, la premiere ligne du programme est composee de la fonction echo qui affi- 
che Bonjour a l'ecran. La page PHP peut comprendre uniquement ce script ou du code HTML dans 
lequel on a integre le script PHP. Dans ce cas, seul le script PHP delimite par ses balises est interprete 
par l'interpreteur PHP ; le code HTML est quant a lui retranscrit a l'identique dans la page finale 
envoyee au navigateur. Si vous enregistrez ce code PHP dans un fichier bonjour. php et que vous 
testez cette page, le navigateur affiche Bonjour. Par la suite, nous enregistrerons toujours nos fichiers 
comportant du code PHP avec l'extension .php. De meme, dans les differents exemples de cet ouvrage, 
nous ne mentionnerons pas les balises PHP car nous considererons que tous les codes affiches doivent 
etre encadres par <?php et ?>. 



La fonction d'affichage echo 

Nous abordons I'etude des fonctions integrees PHP un peu plus loin dans ce meme chapitre. Cependant, nous 
utiliserons la fonction echo des maintenant, afin d'afficher facilement les valeurs des variables ou d'emuler du code 
HTML dans un script PHP. Voici quelques informations sur I'utilisation de cette premiere fonction. Sachez pour 
commencer que la fonction echo est la seule fonction qui ne necessite pas I'usage de parentheses pour encadrer 
ses arguments. Elle permet d'afficher des textes ou des balises HTML s'ils sont encadres par des guillemets 
simples ou doubles. Par exemple, echo "bonjour" ; ou echo 'bonjour' ; affichent le mot bonjour dans la 
page Web. echo "<br>"; emule la balise HTML <br> et provoque un retour a la ligne. La commande echo 
permet egalement d'afficher la valeur d'une variable si elle est encadree par des doubles guillemets ou ne 
comporte pas de guillemets. Par exemple, echo "$varl" ; ou echo $varl ; affichent la valeur de la variable 
$varl dans la page Web. Attention ! Si vous passez dans I'argument le nom d'une variable encadre par des guillemets 
simples, vous affichez son nom et non sa valeur. 

Les commentaires 

Dans un script PHP (zone encadree par les balises <?php et ?>), il est possible de commenter le code 
PHP en utilisant trois syntaxes differentes selon le type de commentaire. 

Commentaires de simple ligne // 

Si on desire inserer un commentaire sur une ligne ou a la fin d'une instruction, il faut ecrire deux 
barres obliques // devant celui-ci : 

echo "Bonjour"; // Ici c'est un commentaire en bout de ligne 
// Ici c'est un commentaire sur une ligne complete 

Commentaires de tete # 

On peut egalement utiliser le symbole # pour commenter une ligne. Cette syntaxe est souvent utilisee 
en tete de programme pour indiquer les differents parametres qui caracterisent le script de la page 
(fonctions realisees par le script, informations en entree et en sortie. . .) : 
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IHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHt 

# Programme de mise a jour - version du 15.01.2003 

# information en entree : $varl, $var2, $var3, $var4 

# information en sortie : actualisation de la table AGENCES 
MHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHt 

Commentaires multilignes /* et */ 

Si on desire inserer plusieurs lignes de commentaire, il faut employer le signe /* au debut de la zone 
de commentaire et */ a la fin de celle-ci : 

/* 

ceci est un commentaire 
sur plusieurs 
1 ignes 
*/ 



Utiliser les commentaires pour deboguer 

Dans le cadre du depannage d'un script PHP, vous pouvez utiliser les commentaires pour neutraliser une ligne ou 
un bloc de code. Cela permet de tester la page sans interpreter la partie neutralisee et d'identifier quel script 
produit I'erreur. Pour plus d'informations sur le debogage d'un programme, reportez-vous au chapitre dedie a la 
mise en ceuvre des programmes. 



Les variables 

La variable et sa valeur 

Les variables sont des symboles auxquels on affecte des valeurs. Apres leur affectation, vous pouvez 
modifier les variables a tout moment au cours du deroulement du programme. La declaration d'une 
variable n'est pas obligatoire en PHP (contrairement a ce qui se passe avec des langages comme le 
C), car la variable peut etre creee lors de sa premiere affectation. De meme, les variables prennent le 
type correspondant a la valeur qui leur est affectee. 

A noter 

Le type d'une variable PHP peut lui aussi changer au cours d'un meme programme selon la valeur qu'on lui affecte 
(contrairement a ce qui se passe dans I'AS). 



Noms des variables 

Les noms des variables sont toujours precedes du caractere $ et suivis du nom choisi pour identifier 
la variable, qui ne doit comporter que des caracteres alphanumeriques (sauf le premier caractere, qui 
ne doit pas etre un chiffre) ou le caractere souligne _. En pratique, il est judicieux de choisir un nom 
explicite et de se fixer une regie de nommage. 
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Types des variables 

Les variables peuvent etre de plusieurs types : 

Tableau 6-2. Les variables PHP peuvent etre de differents types selon leur affectation 



Type de variable 

Chaine de caracteres 

(string) 



Numeriques entiers 
(integer) 

Numeriques decimales 
(doubl e) 



Booleens 
(boolean) 



Tableaux 
(array) 



Objets 
(object) 



Description 

Leurs valeurs sont des lettres, chiffres ou symboles. 
Pour affecter une valeur alphanumerique a une varia- 
ble, vous devez I'encadrer par des guillemets. 
A noter : les guillemets peuvent etre double ( ") ou 
simple ( ')• Une chaine encadree par des guillemets 
simples peut contenir des guillemets doubles et vice 
versa. Si vous devez integrer des guillemets de 
meme type dans la chaine, il faut les faire preceder 
du caractere d'echappement ( \). 

Leurs valeurs sont uniquement des nombres entiers. 
Pour affecter un entier a une variable, il ne doit pas 
etre encadre par des guillemets. 

Leurs valeurs sont uniquement des nombres deci- 
maux. Pour affecter un decimal a une variable, il ne 
doit pas etre encadre par des guillemets. 
A noter : le separateur des valeurs decimales utilise 
en PHP est le point ( . ) et non la virgule ( , ). 

Leurs valeurs sont soit TRUE (vrai), soit FALSE (faux). 
Ces valeurs sont affectees a la variable en utilisant une 
expression de condition (exemple : $varl==$var2). 
La valeur FALSE peut etre le 0, une chaine vide "" 
ou le caractere "0" et la valeur TRUE toutes les 
autres valeurs. 

Un tableau est une seriede valeurs ayanten commun 
le meme nom de variable. II peut etre indice ou asso- 
ciatif. Le premier indice d'un tableau est toujours 
zero. 

Les objets (ou classes) sont des ensembles de varia- 
bles et de fonctions definies par I'utilisateur. 



Exemples 

$varl="Dupond" ; 
$var2="bonjour M. $varl" 
$var3="254"; 
$var4="total=150"; 
$var5= "d'en face" ; 
$var5= 'd\ ' en face' ; 
$var6= ' hi ght="20" ' ; 
$var7= "hight=\"20\" " ; 

$varl=152; 
$var2=5; 
$var3=45+$varl ; 

$varl=152.20; 
$var2=124.50; 
$var3=45.85+$varl; 



$varl=5 ; // var num 

$var2=2 ; // var num 

$var3=($varl==$var2) ; 

/* $var3 est une variable booleenneet 

sa valeur est FALSE dans cecas */ 

$mois[0]="janvier" ; 
$mois[l]="fevrier" ; 
$mois[2]="mars" ; 

class chrono { 
var $varl=2; 
function debutt ) 
{this->$varl=time( ) } 

} 



Comment connaitre le type d une variable ? 

En cours de developpement, vous aurez peut-etre besoin de connaitre le type d'une variable avant de I'exploiter. 
Dans ce cas, il suffit d'utiliser lafonction gettype($varl), qui retourne le type de la variable $varl. En phase de 
mise au point d'un programme, vous pouvez integrer provisoirement dans votre page I'instruction suivante : echo 
gettype($varl) ;, qui affiche le type de la variable directement dans la page Web (string, integer, double, 
boolean, array, object). 



PHP, les bases du langage 

Chapitre 6 



Variables simples 

La facon la plus simple de manipuler une variable est d'utiliser son nom precede d'un caractere $ 
(exemple : $varl). Cette syntaxe est utilisee aussi bien pour son affectation que lors de son utilisation 
au sein d'une page Web (pour les versions de PHP superieures a 4.2, ce type de variable devra etre 
utilise uniquement au sein d'une meme page). Dans l'exemple ci-dessous, le type de la variable $varl 
est numerique comme le type de la valeur qui lui est affectee. 

// Affectation d'une variable simple 
$varl=100; 

// Utilisation d'une variable 

echo $varl; // Ici la valeur de la variable sera affichee dans la page 



Comment tester si une variable existe ? 

Pour tester si une variable a deja ete affectee, on peut utiliser lafonction isset($varl), qui retourne TRUE (vrai) 
si la variable existe (si elle est deja affectee, meme avec une chaine vide ou un 0) et FALSE dans les autres cas (si 
elle n'existe pas encore ou si elle n'a pas ete affectee). A I'inverse, lafonction empty ($varl) permet de tester si 
une variable est vide (une variable vide vaut 0 dans le cas d'une variable numerique ou est une chaine vide dans 
le cas d'une chame de caracteres). Si elle est vide, la fonction retourne TRUE ; elle retourne FALSE dans tous les 
autres cas. (Attention ! Si la variable testee contient une chaine vide ou un 0, les deux fonctions retournent TRUE.) 



A titre d'exemple, voici un cas pratique : afin d'eviter de multiples messages d'erreur du genre Undef i ned 
van' abl e lors de Faffichage de la page, vous serez certainement amene a verifier si vos variables sont 
bien initialisees. Le code suivant (placez-le en debut de page) initialise la variable en question 
uniquement si elle n'existe pas encore (l'instruction if ( ) utilisee dans ce test est presentee dans le 
chapitre) : 

i f ( ! isset($variabl e) ) $variable=" "; 

Variables de variables 

Le nom d'une variable peut lui-meme etre une variable. Dans ce cas, il faut faire preceder l'identifiant de 
la variable de variable par deux $. Dans l'exemple ci-dessous, l'affectation du mot bonjour a $$varl 
equivaut a l'affectation du meme mot a la variable traditionnelle $var2 : 

$varl="var2" ; // Initialise le nom de la variable de variable 
$$varl="bonjour" ; 

// A noter : si 1'on remplace $varl par sa valeur (var2) dans la ligne de code ci-dessus, 
**1' expression est alors equivalente a $$varl=$var2="bonjour" ; 
echo $var2; // Affiche "bonjour" a l'ecran 

Variables par reference 

Depuis PHP 4, il est possible d'affecter a une variable une autre variable par reference. En pratique, 
la nouvelle variable se comporte comme un alias de la variable initiale. Quand vous affectez une 
variable par reference, ce n'est pas la valeur de cette variable qui est affectee a une autre variable, mais 
son adresse memoire. Les deux variables pointent sur la meme adresse memoire et toute modification 
de la nouvelle variable entraine une modification de l'ancienne et vice versa. Les performances des 
affectations d'une variable par reference sont bien plus interessantes que celles d'une affectation 
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classique. Pour affecter une variable par reference, il suffit de faire preceder la nouvelle variable du 
caractere & lors de son affectation : 

$varl="bonjour" ; 
$var2=&$varl ; 

// Affectation de var2 par reference (la variable affectee est precedee de &). 
$varl="hel 1 o" ; // Modification de $varl 

echo $varl; // Les deux variables Svarl et $var2 sont modifiees. 

echo $var2; // Elles affichent done toutes les deux "hello" a l'ecran. 

Variables en tableaux indices 

Les tableaux sont des series de valeurs regroupees sous le meme identifiant. On distingue chaque 
element de la serie par un indice entre crochets (exemple : $tabl[0]). Les tableaux qui utilisent des 
indices numeriques pour distinguer leurs elements s'appellent des tableaux indices. Les indices des 
tableaux commencent toujours a 0. 



Comment connaitre les valeurs contenues dans un tableau ? 

En cours de developpement, vous aurez peut-etre besoin d'afficher rapidement le contenu d'un tableau afin de 
tester votre script. Dans ce cas, il suffit d'utiliser lafonction print_r($tabl), qui affiche directement a l'ecran les 
differentes valeurs du tableau $tabl. Par exemple, si vous desirez connaitre les valeurs du tableau Sagence apres 
son affectation (voir le premier exemple de tableau ci-dessous), vous pouvez integrer provisoirement dans votre 
page I'instruction suivante : 

print_r($agence) 
qui affiche les informations suivantes dans la page Web : 

Array([0]=>Paris [l]=>Lille [2]=>Marsei 1 1 e) 



Si vous desirez afficher des tableaux plus importants, il est preferable de formater la mise en forme 
des resultats a l'aide de la balise HTML <pre> comme dans l'exemple ci-dessous : 

echo "<pre>"; 
print_r($agence) ; 
echo "</pre>"; 

Le contenu du tableau est alors affiche avec la mise en forme suivante : 

Array 
( 

[0] => "Paris" 
[1] => "Lille" 
[2] => "Marseille" 

) 



II existe plusieurs manieres d' affecter des valeurs a un tableau. Chacune ay ant ses avantages et ses 
inconvenients, il faudra choisir la methode d' affectation selon le contexte du programme. 
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La premiere consiste a affecter sa valeur a chaque element en precisant de maniere explicite Findice 
de l'element. Cette methode est bien adaptee a l'affectation isolee d'une variable d'un tableau. 
L'exemple ci-dessous initialise un tableau qui memorise des noms d'agences : 

$agence[0]="Paris"; 
$agence[l]="Li lie"; 
$agence[2]="Marsei lie"; 

La deuxieme consiste a ne pas preciser l'indice de l'element du tableau lors de son affectation. Dans 
ce cas, le premier element affecte est d'indice 0 et les autres sont incrementes au fur et a mesure des 
affectations. Cette methode est bien adaptee a l'affectation d'une serie de variables d'un tableau integree 
dans une structure de boucle. L'exemple ci-dessous realise exactement la meme affectation que l'exemple 
precedent utilisant des indices : 

$agence[]="Pari s" ; 
$agence[]="Lil 1 e" ; 
j $agence[]="Marseil 1 e" ; 

La troisieme maniere consiste a utiliser la fonction array( ). II convient alors de preciser les differentes 
valeurs du tableau dans les arguments de la fonction (separes par des virgules). Cette derniere methode 
est bien adaptee a l'affection initiale et complete d'un tableau de variables. L'exemple ci-dessous 
realise exactement la meme affectation que l'exemple precedent utilisant des indices : 

// Affectation des valeurs 
$agence=ar ray ("Paris", "Li lie", "Marseille"); 
// Utilisation des variables 
echo $agence[0]; // Affiche "Paris" 

Variables en tableaux associatifs 

II est egalement possible de remplacer les indices par un nom explicite (la cle). Dans ce cas, le tableau 
est dit associatif (par exemple, $tabl["nom"]). 

Nous avons decline ci-dessous les exemples expliques precedemment, mais en utilisant cette fois des 
tableaux associatifs : 

$agence["centre"] = "Paris"; 
$agence["nord"] = "Lille"; 
$agence["sud"] = "Marseille"; 

ou bien : 

// Affectation des valeurs 
$agence=array( 
"centre"=>"Paris" , 
"nord"=>"Lille", 
"sud"=>"Marsei lie"); 
// Utilisation des variables 
echo $agence["centre"] ; // Affiche "Paris" 
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Variables en tableaux multidimensionnels 

PHP ne gere pas les tableaux a deux dimensions. II est toutefois possible de creer une telle matrice en 
declarant une autre structure de tableau a la place des differentes variables du tableau principal. Le 
tableau principal se comporte alors comme un tableau a deux dimensions (voir le tableau 6-3 et 
l'exemple ci-dessous). 



Tableau 6-3. Matrice equivalant a l'exemple ci-dessous ($tableauprincipal) 



[x][y] 


[y]=[0] 


[y]=[l] 




[x]=[0] 


Al 


A2 




[x]=[l] 


Bl 


B2 





// Initialisation d'un tableau a 2 dimensions 
$ligneA=array("Al","A2") ; 
$1 igneB=array("Bl","B2") ; 
$tableauprincipal=array ($1 igneA,$l igneB) ; 
// Utilisation de ses elements 
echo $tabl eauprincipal [0] [0] ; // Affiche Al 
echo $tabl eauprincipal [0] [1] ; // Affiche A2 
echo $tabl eauprincipal [1] [0] ; // Affiche Bl 
echo $tabl eauprincipal [1] [1] ; // Affiche B2 

Variables HTTP 

Les variables HTTP sont des sources de contenu dynamique que vous pouvez utiliser dans une appli- 
cation Web. II existe plusieurs families de variables (variable de formulaire, d'URL, de session ou de 
cookie). Elles sont stockees dans des tableaux differents selon leur famille ($_P0ST['varl'L 
$_GET['varl'], $_SESSI0N[ 'varl ' ] , $_C00KIE['varl']). Ces tableaux sont disponibles si l'option 
track_var est activee dans le fichier php.ini. Cette option est toujours activee par defaut dans toutes 
les versions de PHP superieures a 4.0.2. Avant la version 4.1, une syntaxe plus longue et done plus 
difficile a saisir dans le code etait utilisee ($HTTP_P0ST_VARS['varl'], $HTTP_GET_VARS[ 'varl ' ] , 
$HTTP_C00KIE_VARS[ 'varl ' ] , $HTTP_SESSI0N_VARS[ ' varl ' ]). Selon la version PHPde votre serveur, vous 
devrez utiliser Fune de ces deux syntaxes. 



Quelle generation de tableaux de variables HTTP doit-on utiliser ? 

Dans cet ouvrage, nous utiliserons la derniere generation de tableaux de variables HTTP($_P0ST['varl'], 
etc.). Afin d'assurer la compatibilite avec les versions anterieures, les dernieres moutures de PHP permettent 
d'utiliser en parallele les deux generations de tableaux. Nous vous conseillons cependant d'utiliser si possible les 
tableaux de deuxieme generation ($_P0ST[ ' varl' ] , etc.) pourtous vos nouveaux scripts, car il est possible que 
I'utilisation de la premiere generation de tableaux ne soit plus autorisee dans une future version de PHP... 



Nous vous rappelons que depuis la version 4.2 de PHP, le parametre register_globals du fichier 
php.ini est configure a off par defaut. Par consequent, I'utilisation d'une simple variable pour recu- 
perer une valeur n'est plus possible. II faut utiliser les tableaux des variables HTTP que nous vous 
avons presentes ci-dessus. Ainsi, avec une variable nomVar envoyee par un formulaire en methode 
POST, on devra utiliser la variable HTTP $_P0ST['nomVar' ] pour recuperer sa valeur. Cependant, si 
vous desirez utiliser d'anciens scripts sans les modifier, vous pouvez modifier la configuration de 
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PHP et mettre le parametre regi ster_gl obal s a On dans le fichier php . i ni . Une autre solution consiste 
a utiliser la fonction import_request_variables() qui transforme les variables stockees dans les 
differents tableaux de variables HTTP en variables simples. Par exemple, la fonction suivante : 
import_request_variables( "gpc" , "var_") permet de recuperer toutes les variables envoyees en GET, 
POST et COOKIE (grace a l'option "gpc") sous le meme nom que celui de la variable mais prefixee par 
"var_" (par exemple, si vous desirez recuperer la valeur d'un champ de formulaire nomme adresse, 
vous devez utiliser la syntaxe $var_adresse dans votre script). 

Les variables de fichier (lors du telechargement d'un formulaire en methode POST) suivent les memes 
regies. Ainsi, lorsque le parametre regi ster_gl obal s vaut On dans php.ini, la variable $fi lejiame est 
identique a la variable HTTP $_P0ST[ 'file' ][ 'name'], de meme que les trois autres variables de 
fichier presentees dans le tableau 6-4. En revanche, si ce parametre vaut Off (configuration par defaut 
pour PHP 4.2 et plus), il faut utiliser les variables HTTP correspondantes. 

Le fichier de configuration php.ini contient une option error_reporting qui peut etre parametree 
selon le niveau de controle souhaite pour les scripts. Dans les dernieres versions de PHP, cette option 
est configured par defaut avec la valeur E_ALL, qui est le niveau maximal de controle. Avec ce parame- 
trage, toutes les variables non declarees provoqueront automatiquement un warning (Undefined 
van' abl e). Pour eviter ces messages d'erreur, Fideal est d'ajouter une instruction d' initialisation de la 
variable concernee (revoir Futilisation de Finstruction issetO presentee au debut de ce chapitre). 
Vous pouvez aussi remplacer la valeur par defaut par E_ALL & ~ EJOTICE ou encore integrer ponc- 
tuellement la fonction error_reporting(7) ; dans le script de la page concernee. 



Tableau 6-4. Les variables HTTP de PHP 



Famille de variable 


Syntaxe du tableau de variables 


Description 


variable de formulaire utilisant la 
methode POST. 


$_P0ST['varl'] 


Tableau des variables de formulaire qui stocke 
les informations recuperees lors d'une requete 
d'un formulaire utilisant la methode POST. 


variable passee dans I'URL ou issue 
d'un formulaire utilisant la methode 
GET. 


$_GET['varl'] 


Tableau des variables d'URL qui stocke les 
valeurs transmises par I'URL (exemple : bon- 
jour. php? var 1=100) ou saisies par I'internaute 
dans un formulaire utilisant la methode GET. 


variable de session 


$_SESSION['varl'] 


Tableau des variables de session qui memorise 
des informations enregistrees pendant toute la 
duree de la visite de I'internaute (la session). 


variable de cookie 


$_C00KIE['varl'] 


Tableau des variables de cookie qui permet de 
recuperer une information stockee au pream- 
ble sur le poste client. 


variables de fichier 

Lors du chargement d'un fichier depuis 
un formulaire en methode POST, il est 
stocke dans un repertoire temporaire. 
II conviendra done de le copier ensuite 
dans le repertoire desire (a I'aide de la 
fonction copy ou move_uploaded_file 
par exemple) 


$_FILES['file'] ['name'] 
correspond au nom du fichier 
$_FILES['file'] ['type'] 
correspond au type MIME du fichier 
$ _FI LESC "f i 1 e ■ ] ['size'] 
correspond a la faille en octets du fichier 
$ _FI LESC 'file'] ['tmp_name'] 
correspond au nom temporaire du fichier 


Tableau des informations correspondant a un 
fichier telecharge par la methode POST. 
Dans les exemples ci-contre, on suppose que 
le nom du fichier telecharge (soit le nom du 
champ du formulaire) est f i 1 e. 
Attention ! Le formulaire dans lequel est inte- 
gre le champ de telechargement de fichier 
(balise input de type="file") doit etre confi- 
gure avec I'attribut enctype="multipart/ 
form-data" et la methode POST. 
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Parametrage du niveau d'erreur dans Wamp 5 

Dans la suite Wamp 5, le niveau d'erreur est parametre par defaut avec les options suivantes : error_reporting 
= E_ALL & ~E_N0TICE & ~E_STRICT. 

Si vous desirez modifier ce parametre pour avoir les memes conditions de test que sur votre serveur distant, il suffit 
d'acceder au fichier php. ini depuis le manager (Configfile php.ini). 



D'autres variables predefinies fournissent des renseignements precieux, comme les noms du naviga- 
teur client et du systeme d' exploitation ou encore l'adresse IP de l'internaute qui consulte votre site. 
Vous pouvez facilement exploiter ces variables a l'aide du tableau $ J>ERVER[ ' nom_var ' ], qui regroupe 
toutes les variables HTTP. La plupart de ces valeurs sont attributes par le serveur : vous pouvez les 
exploiter dans de multiples applications, mais vous ne devez pas les modifier. Le tableau 6-5 propose 
une liste non exhaustive de ces variables. 



Tableau 6-5. Liste non exhaustive de quelques variables HTTP predefinies 
disponibles sur le serveur Web 



Norn de la variable 


Definition 


$_SERVER[ 'HTTP_USER_AGENT' ] 


Contient le nom et la version du navigateur utilise par l'internaute. 


$_SERVER[HTTP_ACCEPT_LANGUAGE' ] 


Contient le code de la langue parametree dans le navigateur de l'internaute 
(par exemple f r, si le navigateur est en version franchise). 


$_SERVER[ ' REMOTE_ADDR' ] 


Contient l'adresse IP de l'internaute qui consulte la page. 


$_SERVER['D0CUMENT_R00T'] 


Contient le nom du repertoire de la page affichee. 


$_SERVER[ ' QUERY_STRI NG ' ] 


Contient les informations passees dans l'URL apres le caractere ? 


$_SERVER['PHP_SELF'] 


Contient le chemin et le nom de la page Web en cours de traitement. 


Exemple : 

echo $_SERVER['PHP_SELF']; 

// Affiche le chemin de la page en cours 

echo $_SERVER['QUERY_STRING']: 

/* Affiche les informations passees dans l'URL apres le point d'interrogation 
(exemple : si dans l'URL page.php?varl=20, alors varl=20 est affiche a I'ecran) 7 



Les constantes 

II est possible de definir des constantes a l'aide de la fonction deffneO. Contrairement aux variables, 
les valeurs affectees initialement a une constante ne peuvent plus etre modiflees. Les deux principaux 
avantages des constantes sont qu'elles rendent le code plus explicite et qu'on peut modifier leur 
valeur en un seul point alors qu'elles sont accessibles globalement en tout endroit du code (contraire- 
ment aux variables, qui ont une duree de vie limitee a l'execution du script de la page). II est d'usage 
(mais ce n'est pas obligatoire) de nommer les constantes avec des majuscules. Vous pouvez acceder a 
une constante en indiquant son nom. (Attention ! Ne mettez pas de $ devant ce nom.). 
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Tableau 6-6. Definition d'une constante 



Syntaxe 

define (nom_constante, valeur) 

Exemple : def ine( " REP_I MAGES" , "/monsi te/ images/ " ) ; 

Pour definir une constante, il faut utiliser la fonction deflneO. 



A noter 

II existe des constantes predefines par PHP comme _Fll_E_, qui contient le nom du fichier en cours d'utilisation, 
_LINE_, qui contient le numero de ligne actuellement execute ou encore PHP_VERSI0N, qui contient la version de 
PHP installee sur le serveur. (_fi LE_ et _LINE_ sont des exceptions et sont appelees constantes magiques, car 
leur valeur n'est pas figee comme dans le cas d'une veritable constante mais peut evoluer au cours du 
programme.) 



Voici un exemple d'utilisation de constantes : 

def ine( "ANNEENAISSANCE" , 1960) ; 

defineC'TEXTE" ,"Je suis ne "); 

echo TEXTE. "en" .ANNEENAISSANCE; 

// Affiche alors "Je suis ne en 1960"; 



Expressions et instructions 
Les expressions 

On appelle « expression » tout regroupement d' elements du langage de script qui peut produire une 
valeur (une simple variable $a peut done etre consideree comme une expression puisqu'elle produit 
une valeur lors de son evaluation). Les expressions sont constituees de variables, d'operateurs ou de 
fonctions. On les utilise pour construire des instructions ; dans ce cas, elles sont terminees par un 
point-virgule et elles peuvent etre executees. Les expressions servent egalement pour elaborer des 
conditions de tests, que nous etudierons dans le chapitre dedie aux structures de programme ; dans ce 
cas, elles sont converties en booleen TRUE ou FALSE lors de leur evaluation par l'interpreteur PHP. 

Voici quelques exemples d' expressions (en gras) : 
$a=100 

$resultat=fonction( ) 
if ($a>5) 

Les instructions 

On appelle « instruction » une expression terminee par un point-virgule. Les instructions sont traitees 
ligne par ligne lors de F interpretation du code PHP. 

Voici quelques exemples d' instructions : 

$a=100; // Cette premiere instruction affecte la valeur 100 a la variable $a 
echo $a; // Cette deuxieme instruction affiche la valeur de $a (soit 100) 
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Les operateurs 

Les operateurs permettent de lier des variables ou des expressions. II existe differentes families 
d'operateurs selon les fonctions realisees ou les expressions avec lesquelles on peut les employer 
(affectation, arithmetique, comparaison, logique ou de chaine). 

Operateurs d'affectation 

L'operateur d'affectation est le plus courant. On peut aussi l'utiliser sous une forme compacte inte- 
grant une operation arithmetique puis une affectation. 



Tableau 6-7. Operateurs d'affectation 



Symbole 


Definition 


Affectation de base 


+! 


Addition puis affectation 


Soustraction puis affectation 


*= 


Multiplication puis affectation 


/= 


Division puis affectation 




Modulo puis affectation 



L'operateur d'affectation de base permet d'attribuer une valeur issue d'une expression. Les autres 
operateurs d'affectation permettent en outre de realiser des operations arithmetiques. 

Voici quelques exemples : 

$varl=0;// Affectation de base (initialisation de $varl a 0) 
echo $varl; 

$varl+=2;// Ici $varl vaut 2 (0+2) 
echo $varl; 

$varl+=14;// Et maintenant $varl vaut 16 (2+14) 
echo $varl; 

Operateurs arithmetiques 

Lorsqu'on gere des variables de type numerique, on dispose d'operateurs arithmetiques qui peuvent 
realiser toutes les operations mathematiques standards. 

A noter 

Si Ton desire forcer la priorite d'execution d'une operation, il est possible d'utiliser les parentheses pour encadrer 
I'expression a executer en premier. 

Enfin, F incrementation et la decrementation (addition ou soustraction d'une unite) sont souvent utilisees 
en programmation et PHP fournit des operateurs specifiques pour ce faire (++ et --). 

A noter 

Vous pouvez placer les operateurs avant ou apres la variable. La difference est que la variable est modifiee avant 
(exemple : ++$a) ou apres ($a++) que le resultat de I'expression ne soit retourne. 
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Tableau 6-8. Les operateurs arithmetiques permettent d'appliquer 
des operations mathematiques a des variables de type numerique 



Symbole 


Definition 




+ 


Addition 




Soustraction 


\l 


Division 




* 


Multiplication 




% Modulo : I'expression $ a % $b retourne le reste de la division de $a par $b 


++ Increment ($a++ ou ++$ a) 




Decrement ($a-- ou --$a) 






Voici quelques exemples : 

$varl=5+2; // Addition de deux valeurs numeriques 
echo $varl; 

$var2=2+$varl ; // Addition d'une valeur numerique et d'une variable 
echo $var2; 

II 

$var5=14; 

$var4=$var5£5; // 14 modulo 5 est egal a 4 (14/5=2 et reste 4) 
echo $var4 ; 

// 

$var3=($var2+$varl)/2; 

// Utilisation des parentheses pour forcer les priorites des operateurs 
echo $var3; 

++$var3; // Apres cette incrementation, la variable est egale a "$var3+l" 
echo $var3; 

Operateurs de comparaison 

Les operateurs de comparaison sont utilises dans les expressions de condition des structures de programme 
(voir le chapitre sur les structures de programme) ou avec l'operateur ternaire presente ci-apres. lis 
permettent de comparer deux expressions. L' expression qui resulte de cette comparaison est egale a TRUE 
(vrai ou 1) lorsque la condition a controler est verifiee et a FALSE (faux ou 0) dans le cas contraire. 



Tableau 6-9. Operateurs de comparaison 



Symbole 


Definition 


l== l|gal 


< 


Inferieur strict 


> 


Superieur strict 


<= 


Inferieur ou egal 


>= 


Superieur ou egal 


! = Different 
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L'operateur de comparaison permet d'elaborer des expressions de condition que vous pouvez utiliser 
dans les instructions de structure du programme (i f, whi 1 e, for...). 

Voici quelques exemples d'utilisation d'expressions de condition : 
$varl=5; // Initialise la variable pour le test 

$var2=($varl==5) ; // Evaluation de la condition. Attention ! il y a deux signes "=" 
// Teste si $varl est egale a 5. Apres revaluation de cette expression de 
// condition, la variable $var2 prend la valeur "TRUE" dans le cas present 
// et devient done une variable de type booleen. 
echo $var2; 

// Si le test est positif, $var2 affiche "TRUE" 

// 

if($varl>2) //teste 1 'expression de condition 

{echo "le test est positif";} 

// 

echo ($varl>2)?"le test est positif'V'le test est negatif"; 

// Utilisation d'une expression de condition avec l'operateur ternaire 

Operateur ternaire 

L'operateur ternaire permet de tester rapidement une expression de condition et d'effectuer une 
action specifique selon le resultat du test. Nous verrons qu'il est possible d'utiliser les structures de 
choix (avec les instructions i f et el se) pour realiser la meme action. Dans ce cas, la syntaxe est moins 
concise. 

Tableau 6-10. Operateur ternaire 

Syntaxe 

[expression de condition]?[expression effectuee si vrai]:[expression effectuee si faux] 

Exemple: ($varl>2)?($var3="oui ") : ($var3="non") 

dans le cas oil $varl est superieure a 2, oui est affecte a $var3, sinon e'est non. 

L'operateur de choix ternaire permet de realiser 1' equivalent d'une petite structure de choix utilisant 
if et el se. 

Voici un exemple : 
$lg="fr"; 

echo ($1 g=="f r" )?"bonjour" : "hel 1 o" ; 

// Le test ternaire est tres bien adapte a la personnalisation d'un petit texte selon 
// la langue choisie par 1 'utilisateur (a 1 'aide d'une variable "$lg" initial i see 
// avec "fr" ou "en" par exemple). 

Operateurs logiques 

Les operateurs logiques permettent de composer des expressions de condition complexes a partir de 
variables booleennes ou d'autres expressions de condition. Vous pouvez utiliser les parentheses pour 
forcer les priorites entre les operateurs ou pour ameliorer la lisibilite du code en encadrant les expressions 
de condition. 
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Tableau 6-11. Operateurs logiques 



Symbole 


Exemple 


Fonction 


Definition 


&& 


$varl && $varZ 


ET 


Renvoie TRUE (vrai) si les deux variables $varlET$var2 sont TRUE. 


AND 


$varl AND $var2 






II 


$varl | | $var2 


OU 


Renvoie TRUE (vrai) si au moins Tune des deux variables $varl OU 
$var2 est TRUE. 


OR 


$varl OR $var2 






XOR 


$varl XOR $var2 


OU exclusif 


Renvoie TRUE (vrai) si I'une des deux variables $varl OU $var2 est 
TRUE, mais pas les deux. 


I 


!$varl 


Negation 


Renvoie la negation de $varl. 



L'operateur logique permet de relier logiquement deux expressions booleennes. 
Voici deux exemples : 

if($varl>2) AND ($varl<5) 

(echo "la variable $varl est plus grande que 2 mais inferieure a 5";} 

// 

if($varl=="jean") OR ($varl=="fred") OR ($varl=="marie") 
(echo "la variable $varl est jean, fred ou marie";) 

Operateur de concatenation 

L'operateur de concatenation est souvent utilise pour former des expressions a partir d'elements de 
differents types (variable avec du texte par exemple) ou a partir d'autres expressions. L'operateur 
utilise pour relier ces expressions est le point. Comme pour les operateurs arithmetiques, il existe une 
forme compacte d' affectation d'une concatenation. Elle est frequemment utilisee pour regrouper 
differentes expressions dans une meme variable (voir exemple ci-dessous). 



Tableau 6-12. Operateur de concatenation 



Syntaxe 


Forme normale : 


[expression 3]= 


[expression 1] . [expression 2]; 


Exemple : $var3= 


$varl . "euros" 


// Si $varl est egale a 50, alors $var3 est egale a "50 euros" 


Forme compacte 


: [expression 3] 


.=[expression 2]; 


Exemple 




$varl="Monsi eur" ; Apres ces deux instructions, $varl est egale a 
$varl. = "Dupond"; Monsieur Dupond 



L'operateur de concatenation permet de regrouper deux expressions et d'affecter ce resultat a 
l'expression de gauche. 

Voici quelques exemples : 

$varl="Jean" ; 
$var2="Fred" ; 
$var3=$varl . " et ".$var2; 
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echo $var3;// On affiche "Jean et Fred" a l'ecran 

// 

$var3="Bonjour" ; 
$var3.=$varl; 
$var3.=" et "; 
$var3.=$var2; 

echo $var3;// On affiche "Bonjour Jean et Fred" a l'ecran. 



Bibliotheques de fonctions integrees a PHP 

On appelle bibliotheque un ensemble de fonctions qui permettent de realiser des taches relatives a un 
meme domaine. Vous pouvez regrouper ces fonctions dans un fichier commun avec i ncl ude( ) ou les 
integrer a des bibliotheques natives PHP. Dans le deuxieme cas, il est plus utile de faire reference aux 
fichiers extemes qui contiennent les fonctions, car celles-ci restent en permanence dans la memoire 
de Fordinateur et sont ainsi interpreters automatiquement lors de leur appel. Ces fonctions integrees 
sont regroupees en bibliotheques et sont facilement identifiables par leur nom, qui contient souvent 
un prefixe commun a chaque bibliotheque (exemple : mysql_connect( ), strpos( )...). La liste des 
fonctions integrees est longue. Nous en avons selectionne quelques-unes que nous presentons ci- 
dessous. Nous vous invitons a consulter la documentation PHP (www.php.net) si vous desirez exploiter 
une fonction specifique. 



Consulter les references de poche PHP 

Dans le chapitre 4, nous avons presente le mini-dictionnaire des fonctions PHP integre au panneau Code, onglet 
Reference de Dreamweaver. Nous vous invitons a consulter sans moderation cette ressource afin de completer 
notre selection de fonctions integrees. 



Fonctions PHP generates 



Tableau 6-13. Les principales fonctions PHP generales 



Syntaxes et exemples 


Description 


empty($var) 


Retourne le booleen FALSEsi la variable $var est definieou a une valeur. 
Retourne TRUE dans le cas contraire. 


define(nom_cst,va leur. opt ion) 


Definit une constante nom_cst qui a pourvaleur "valeur".Par defaut, le nom de la 
constante est sensible a la casse, mais si I'argument opti on est egal a 1, le nom est 
insensible a la casse. 


header( "chai ne" ) 


Produit un en-tete HTTP comme Content-type, Location, Expires... 


isset($var) 


Retourne TRUE si la variable $var est definie et a une valeur. 
Retourne FALSE dans le cas contraire. 


md5( "chaine" ) 


Fonction de codage qui retourne une chaine de 32 octets associee a I'argument 
chaine. 


phpinfot ) 


Affiche les informations sur I'interpreteur PHP installe sur le serveur. 


randt ) 


Retourne une valeur aleatoire. 
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Fonctions PHP dediees aux tableaux 

Les tableaux de variables sont frequemment employes en programmation. PHP propose de nombreuses 
fonctions pour gerer leur contenu (tri, navigation dans le tableau, acces aux elements. . .). Le tableau 6-14 
recapitule les fonctions les plus couramment employees. 



Tableau 6-14. Principales fonctions PHP dediees aux tableaux 



Syntaxes et exemples 




Descriptions 


array_wal k($tabl , nom 


_fonction) 


Execute la fonction nom_f oncti on sur chaque element du tableau $tabl. 


arsort($tabl) 




Trie le tableau $tabl par ordre decroissant. 


asort($tabl) 




Trie le tableau $tabl par ordre croissant. 


count($tabl) 




Retourne le nombre d'elements contenus dans le tableau $tabl. 


Exemple : 






ttahl = arrau( "Pan* q" 


'DonnQc" "1 illfl i < 

i\ L IIIICO , LIIIC I , 




echo count($tabl) ; 






// Affiche le nombre 


d' elements, done 3 




current($tabl) 




Retourne I'element courant du tableau $tabl mais n'avance pas le poin- 






teur interne du tableau. 


each($tabl) 




Retourne chaque paire cle/valeur du tableau $tabl et avance le pointeur 






interne du tableau. Si le pointeur arrive a la fin du tableau, retourne FALSE. 


end($tabl) 




Place le pointeur interne sur le dernier element du tableau $tabl. 


key($tabl) 




Retourne la cle de la position courante d'un tableau associatif $tabl. 


next($tabl) 




Avance le pointeur interne du tableau $tabl et retourne I'element suivant 






du tableau ou FALSE en fin de tableau. 


prev($tabl) 




Recule le pointeur interne du tableau $tabl. 


reset($tabl) 




Place le pointeur interne sur le premier element du tableau $tabl. 



Fonctions PHP dediees aux dates 

Les fonctions de date et d'heure de PHP se referent au tampon horaire UNIX. Ce tampon contient le 
nombre de secondes qui se sont ecoulees depuis le debut d'UNIX, soit le premier janvier 1970 a OhOO 
(heure Greenwich GTM). 



Tableau 6-15. Principales fonctions PHP dediees aux dates 



Syntaxes et exemples 


Description 


checkdate($month , $day , $year) 

checkdate(03.20,2002); 

// Retourne TRUE car la date du 

20 mars 2002 existe 


Verifie la validite d'une date et retourne TRUE si elle est valide et FALSE dans 
le cas contraire. 


date( "format" , $date) 
$aujourdhui=date("d/m/y") ; 
// Retourne la date du jour au for- 
mat suivant : 30/01/03 


Formate une date. Retourne une chaine de caracteres au format impose par 
format (il existe de nombreux formats possibles). La date est fournie par $date, 
mais si ce parametre n'est pas mentionne, e'est par defaut la date courante qui 
est retournee. 
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Tableau 6-15. Principales fonctions PHP dediees aux dates (suite) 

mktime($h,$min,$sec,$mon,$day,$ Retourne le tampon UNIX (temps reference en secondes depuis le 1 er janvier 

year[,int is_dst] ) 1970) correspondant a la date indiquee en parametre. 

mktimedO, 0,0, 1,25, 2003, 1) ; A noter : I'argument optionnel is_dst permet de tenir compte de I'heure 

// Retourne en secondes : 1043481600 d'hiver (si I'heure d'hiver est appliquee, is_dstd et 0 sinon). 

getdate(tampon_UNIX) Appelee sans parametre, cette fonction retourne un tableau associatif qui 

// Ce script affiche I'heure contient la date et I'heure actuelle. Si unevaleur de tampon UNIX est indiquee, 
actuel 1 e ' e tableau contient les informations en rapport avec ce tampon. Pour recuperer 

// par exempt e • 11 est 18 h 45 une information de ce tableau Jl faut utiliser la cle adaptee, par exemple : 

$datejour=getdate( ) ; $aujourdhui=getdate( ) j 

$heure=$datejour[hours] ; ecno $aujourdhui [mday] ; // jour du mois (numerique de 1 a 31); 

$min=$datejour[minutes] ; ecno Jaujourdhui [mon] ; // mois (numerique de 1 a 12); 

echo "il est ".$heure." h ".$min; ecno taujourdhui [year] ; // annee (numerique par ex : 2004); 

echo $aujourdhui [hours] ; // heure (numerique de 0 a 23); 

echo $aujourdhui [minutes] ; // minutes (numerique de 0 a 59); 

echo $aujourdhui [secondes] ; // secondes (numerique de 0 a 59); 



Fonctions PHP dediees aux chaines de caracteres 

Certaines fonctions de gestion des chaines de caracteres sont tres importantes dans les sites dynami- 
ques. En effet, lorsqu'on ajoute dans une base de donnees une chaine comportant des caracteres 
speciaux (« ' » par exemple), le serveur MySQL signale une erreur. La solution consiste a faire 
preceder ces caracteres speciaux d'une barre oblique inverse grace a la fonction AddSlashesO. La 
fonction StripSl ahes( ) permet ensuite de les supprimer. 



Tableau 6-16. Principales fonctions PHP dediees aux chaines de caracteres 



Syntaxes et exemples 




trim($chaine) 


Supprime les espaces initiaux et finaux d'une chaine de caracteres $chaine. 


str_replace($chl,$ch2,$ch3) 


Substitue une chaine $ch2 atoutes les occurrences d'une chaine de recherche 
$chl dans une chaine specifique $ch3. 


St ripSl ashes ($chaine) 
$chainel="aujourd\ ' hui "; 
$chaine2=StripSl ashes($chainel); 
echo $chaine2; 
// Affiche "aujourd' hui " 


Supprime les barres obliques inverses devant les caracteres speciaux de la 
chaine $chaine. 




AddSlashes($chaine) 

$chainel="aujourd'hui"; 

$chaine2=AddSl ashes ($chainel); 

echo $chaine2; 

// Affiche "aujourd\ ' hui " 


Ajoute une barre oblique inverse devant les caracteres speciaux d'une chaine 
$chaine. 


strtolower($chaine) 


Renvoie la chaine $chaine en minuscules. 


strtoupper($chaine) 


Renvoie la chaine $chaine en majuscules. 
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Tableau 6-16. Principales fonctions PHP dediees aux chaTnes de caracteres (suite) 
Syntaxes et exemples Description 

explode($separe,$chaine) Scinde la chaine Schaine en plusieurs parties selon le separateur $separe. 

$chainel="Paris: Rennes: Lil le"; Retourne un tableau des valeurs ainsi separees. 

$tabl= explode(":",$chainel) ; 
// Retourne le tableau suivant : 
array ("Paris". "Rennes" ."Li lie") 

i mpl ode ( $separe . $tab ) Retourne une chaine de caracteres constitute de tous les elements du tableau 

$tab=array("Paris","Ren- *tab separes par $separe. 

nes", "Lille") ; 

$chainel= i mpl ode(": " , $tab) ; 
echo Schainel; 

/* Affiche la chaine suivante : 
"Paris : Rennes: Lil 1 e" */ 



Fonctions PHP dediees aux fichiers 

La plupart des operations de base realisables avec des fonctions PHP necessitent le passage en argu- 
ment d'un identifiant de fichier que nous noterons $i d dans le tableau 6-17. Cet identifiant est obtenu 
lors de l'ouverture du fichier a Faide de la fonction fopen( ). Pour toutes les operations d'ecriture, il 
faut s' assurer au prealable que les droits du fichier sont configures en consequence (vous pouvez rapi- 
dement realiser ce parametrage a l'aide de la fonction chmod de votre outil de FTP). 



Tableau 6-17. Principales fonctions PHP dediees aux fichiers 



Syntaxes et exemples 


Description 


fopen( "nom_f ichi er" , "mode" ) 

$i d=f open ( "monfi chier.txt" , "r" ) ; 


Ouverture d'un fichier selon le mode Mode (voir detail ci-dessous). Retourne un 
identifiant ($id par exemple) necessaire dans d'autres fonctions de manipula- 
tion de fichiers. 



Le parametre mode de la fonction fopen( ) definit les modes d'ouverture suivants : 

"r" : ouvre un fichier en lecture seule et place le pointeur en debut du fichier. 

"r+" : ouvre un fichier en lecture et en ecriture et place le pointeur en debut du fichier. 

"w" : ouvre un fichier en ecriture seule et place le pointeur en debut du fichier, mais en supprimant le contenu existant. Si le 
fichier n'existe pas, il est cree. 

"w+" : ouvre un fichier en lecture et ecriture et place le pointeur en debut du fichier, mais en supprimant le contenu existant. Si 
le fichier n'existe pas, il est cree. 

"a" : ouvre un fichier en ecriture seule et place le pointeur a la fin du fichier (ajout). Si le fichier n'existe pas, il est cree. 
"a+" : ouvre un fichier en lecture et ecriture et place le pointeur a la fin du fichier (ajout). Si le fichier n'existe pas, il est cree. 

copy($source,$destination) Copie le fichier $source dans le fichier $destination (si $destination 

$fichier="index.php" ; n'existe pas, il est cree). Si I'operation est effectuee, la fonction retourne TRUE 

copy($fichier,$fichier.'.bak'); sinon FALSL 

// Ici, on realise une copie de 
sauvegarde "index. php.bak" 

fpassthru("nom_f ichier") Lit completement le fichier et I'affiche dans le navigateur. Le fichier peutetre un 

fichier texte ou un fichier image (binaire). 
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Tableau 6-17. Principales fonctions PHP dediees aux fichiers (suite) 



Syntaxes et exemples 


Description 


fi 1 e_exi sts( "nom_f ichier" ) 


Retourne la valeur TRUE si le fichier le fichier existe. Sinon retourne FALSE. 


f i 1 e( "nom_f i chier" ) 


Lit un fichier et retourne un tableau contenant une ligne du fichier dans chacun 
de ses elements. 


fgetc($id) 


Lit un caractere du fichier ouvert avec $id. 


fgets($id, "nombre") 


Lit un nombre donne d'octets (nombre) du fichier ouvert avec $id. 


f read($id, "nombre" ) 




fputs($id, "chaine" ) 


Ecrit une chaine de caracteres (chaine) dans un fichier ouvert avec Sid. 


fwrite($id,"chaine") 




rewind($id) 


Place le pointeur du fichier au debut du fichier ouvert avec $id. 


feof($id) 


Retourne la valeur TRUE si le pointeur de fichier se trouve a la fin du fichier ou 
s'il y a une erreur. Sinon retourne FALSE. 



fclose($id) Ferme un fichier ouvert par lafonction fopent). 



Dans l'exemple ci-dessous, la valeur du fichier est lue, incrementee puis enregistree dans le meme 
fichier. 

<?php 

$fichier=f open ("monfichier.txt" , "r+") ; 

// Ouverture du fichier "monfichier.txt" en mode lecture/ecriture 
$so rt ie=f gets ($f ichier, 10 ) ; 
$sortie++; // Incremente la valeur 

fseek($fichier,0) ; // Positionne le pointeur en debut de fichier 
fputs($fichier, Ssortie); 

// Ecriture de la nouvelle valeur dans le fichier 
fclose($fichier) ; // Fermeture du fichier 

?> 

Dans l'exemple ci-dessous, un texte est ajoute a la suite du contenu actuel du fichier : 
<?php 

$f ichier=f open ( "monfichier.txt" , "a" ) ; 

// Ouverture du fichier "monfichier.txt" en mode ajout 

fwrite($fichier, "texte ajoute a la suite"); 

// Ecriture d'un texte a la suite du contenu du fichier 

fclose($fichier) ; // Fermeture du fichier 

?> 
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Dans l'exemple ci-dessous, chaque ligne du fichier est enregistree dans un element de tableau puis 
affichee a Fecran : 

<?php 

$tabl eau=f i 1 e( "monfichier.txt" ) ; 

// Lecture du fichier et enregi strement des lignes dans un tableau 
foreach (Stableau as Snumero => $ligne) {; 
echo $numero." : ".$ligne."<br>"; 

} 

// Affichage de chaque ligne du tableau 

?> 

Dans l'exemple ci-dessous, une image est lue puis affichee dans le navigateur : 
<?php 

$f ichier=f open ( "monimage.gif " , "r" ) ; 

// Ouverture du fichier "monimage.gif" en mode lecture 

fpassthru($fp) ; 

// Lecture et affichage du fichier dans le navigateur 

exit; // Sortie du script (la fermeture du fichier est realisee automatiquement 

*»a la fin de la lecture du fichier) 

?> 

Dans l'exemple ci-dessous, chaque ligne du fichier est lue puis affichee : 
<?php 

$f ichier=f open ( "montexte.txt" , "r" ) ; 

// Ouverture du fichier "montexte.txt" en mode lecture 

while( !feof($fichier)) { 

// Test de boucle (conditionnee par la fin du fichier) 
$1 igne=fgets($fichier,4096) ; // Lecture d'une ligne 
echo $1 i gne ; // Affichage de la ligne a 1'ecran 
} 

fclose($fichier) ; // Fermeture du fichier 
?> 



Attention aux droits des repertoires sur votre site distant 

Si vous desirez utiliser des fonctions dediees aux fichiers sur votre site distant, sachez qu'il sera alors necessaire 
de configurer les droits du repertoire contenant le fichier concerne. Pour changer les droits d'un repertoire, la 
methode la plus simple est d'utiliser la fonctionnalite CHMOD de votre client FTP (par exemple, avec le client FTP 
de Dreamweaver, il suffit de faire un die droit sur le repertoire distant a modifier et de choisir I'option Gerer les auto- 
risations). Vous pouvez aussi automatiser cette configuration directement dans votre script PHP a I'aide de la fonc- 
tion CHMOD ( ) comme I'illustre l'exemple ci-dessous : 
chmod( ??????) 
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Fonctions PHP dediees a MySQL 

PHP dispose de nombreuses fonctions dediees a la gestion de la base MySQL. Ces fonctions 
commencent toujours par mysql_. Nous vous presentons ci-dessous celles qui sont le plus couramment 
utilisees (tableau 6-18). 

Tableau 6-18. Principales fonctions PHP dediees a MySQL 

Syntaxes et exemples 



mysql_connect ( "nom_hote" ."login", "password" ) 
// Ci-dessous la meme fonction avec 1 'option con- 
nexion persistante 

mysql_pconnect ( "nom_hote" , "1 ogin" , "password" ) 

// Exemple : creation d'un identifiant de connexion 

"$id" 

$i d=mysql_connect ( "1 oca host" , "sport" , "eyrol les" ) ; 



mysql_sel ect_db ( "nom_base_donnees" ) 

// Exemple : selection de la base de donnees 

"sport_db" 

mysql_sel ect_db ( "sport_db" ) ; 

mysql_query ( "requete_SQL" , "id_connexion" ) 
// Exemples : 

$resul t=mysql_query ("SELECT * FROM adherents ", 
$id); 

$resul t=mysql_query ($query ,$id) ; 

mysql_fetch_array ("resultat_query" [ , type_tabl eau] ) 
// Argument optionnel : type_tableau : 
// MYSQL_ASSOC : tableau associatif 
// MYSQLJWM : tableau indice 
// MYSQL_BOTH : tableau mixte (par defaut) 

// Exemple : 

$membres=mysql_fetch_array ($resul t) ; 



Description 

Permet d'etablir la connexion avec le serveur de base de 
donnees MySQL. Le nom de I'hote, I'identifiant et le mot 
de passe sont communiques comme arguments de 
cette fonction. lis doivent evidemment etre configures au 
prealable sur le serveur MySQL. Dans le cas d'un heber- 
gement mutualise, ces informations vous sont communi- 
quees par votre hebergeur. 

Cette fonction retourne un identifiant de connexion qu'il 
convient d'enregistrer dans une variable (exemple : $ 1 d), 
afin de pouvoir I'utiliser dans les autres fonctions MySQL. 

Permet de selectionner une base de donnees dont le 
nom est communique en argument de la fonction. 



Permet d'envoyer une requete SQL au serveur. Vous 
pouvez saisir la requete directement dans la fonction ou 
la determiner au prealable dans une variable (exemple : 
$query) et la passer en argument dans la fonction. 



Permet de fournir le resultat de la requete dans un 
tableau associatif, indice ou mixte (selon I'argument 
optionnel type_tabl eau). La variable contenant le 
resultat de la requete doit etre passee en parametre 
dans le premier argument (exemple : $resul t). 



mysql_free_result ("id_query") 


Permet de vider les resultats obtenus a I'aide de la pre- 


// Exemple : 


cedente requete avant de sortir de la procedure. 


mysql_f ree_resul t ($result); 




Legendes : 


[xxx] : le code xxx est facultatif 




(Attention ! Vous ne devez surtout pas saisir les crochets 




[ et ] dans le code.) 



L' exemple ci-dessous est un script complet de connexion et d'affichage des noms d' adherents de la 
base sport_db : 

/* Script de connexion a la base "sport_db" et d'affichage de la table "adherents" */ 

'I 

$id=mysql_connect( "1 ocal host" , "sport" , "eyrol 1 es" ) ; 
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II Le serveur est "1 ocal host" , 1 ' identifiant "sport" et le mot de passe "eyrolles". 

II 

mysql_sel ect_db( "sport_db" ) ; 

// Selection de la base de donnees "sport_db". 
// 

$query="SELECT * FROM adherents"; 

// Elaboration de la requete SQL et enregi strement dans la variable "$query". 
// 

$result=mysql_query($query ,$id) ; 

// La requete "$query" est envoyee au serveur accompagnee de son identifiant "$id" 
// 

whi 1 e ($agences=mysql_fetch_array($resul t ) ) 

{ 

echo "L'adherent " .$adherent[nom] . " est inscrit au club de SPORT <br>"; 
} 

// Recuperation des donnees dans le tableau $adherents[] et affichage. 

// 

mysql_free_resul t($resul t) ; 

// Libere la memoire des resultats obtenus 

Dans le chapitre consacre aux bases de donnees, vous trouverez un exemple d' application de la gestion 
des requetes SQL au projet SPORT. 



Ne melangez pas les langages ! 

Dans le chapitre 1 , nous avons vu qu'une page dynamique etait composee de scripts PHP integres dans une struc- 
ture de page HTML. Le langage SQL prend place dans la meme page dynamique. On le retrouve notamment en 
argument de la fonction PHP mysql_query( ), qui permet de transmettre la requete SQL a la base de donnees. 
Ces trois langages sont done integres dans le meme code d'une page dynamique et il est tres important de ne pas 
les melanger : ce sont des langages differents dont il faut respecter la syntaxe. 
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Notions de base et terminologie 

Presentation de Flash et d ActionScript 

Flash, un outil d'animation et de prog ram mation 

Flash permet de creer des animations simples mais aussi des applications Web complexes et interac- 
tives. Ces applications peuvent etre enrichies d' images, de son et meme de video. Flash propose de 
nombreuses fonctionnalites avancees, qui en font un outil a la fois puissant et facile d'emploi. 

Lorsque vous travaillez dans Fenvironnement auteur de Flash, vous travaillez dans un document 
Flash qui porte l'extension . f 1 a. Si vous desirez diffuser son contenu, vous devez le publier et creer 
pour ce faire un fichier SWF. Les fichiers portant l'extension .swf peuvent ensuite etre consultes a 
l'aide d'une application nommee Flash Player. Elle est chargee d'executer les animations creees dans 
Flash. Flash Player est integre par defaut dans la plupart des navigateurs Internet et ne requiert de 
telecharger aucun plug-ing sur le poste de l'utilisateur lors de la consultation des fichiers SWF (s'il 
s'agit d'une version recente de navigateur). II est egalement possible de mettre a jour gratuitement 
Flash Player pour les anciennes versions de navigateur. 



En cas de probleme d'aff ichage dans Internet Explorer 

Si vous rencontrez des problemes d'atfichage de votre page HTML contenant I'application Flash dans le navigateur 
Internet Explorer, reportez-vous a la fin du chapitre 24 pour connaitre la procedure a suivre pour resoudre ce 
probleme. 
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Programmer dans Flash avec ActionScript 2.0 

ActionScript est le langage de programmation utilise pour developper des applications interactives 
dans Flash. Evidemment, vous pouvez tres bien utiliser Flash sans ActionScript mais si l'interactivite 
est une de vos priorites ou si vous souhaitez creer des applications evoluees, ActionScript est indis- 
pensable. 

Depuis son introduction, ActionScript n'a cesse d'evoluer. Chaque version de Flash voit l'ajout de 
nouveaux mots-cles, objets, methodes et autres elements de langage. Cependant, contrairement aux 
versions anterieures, dans Flash 8 et Flash Professionnel 8, plusieurs nouveaux elements de langage 
facilitant la programmation orientee objet ameliorent considerablement la mise au point et le debo- 
gage des scripts. Ces nouveautes constituent une amelioration significative du langage et ont motive 
sa nouvelle appellation : ActionScript 2.0. 



Remarque 

Dans cet ouvrage, nous utiliserons la version 2.0 d'ActionScript ainsi que Flash Player 8 pour executer les 
animations. 



Terminologie employee en programmation ActionScript 

Voici les termes utilises dans la programmation ActionScript. Rassurez-vous : meme si ces explica- 
tions succinctes vous semblent un peu floues, vous aurez de multiples occasions de conforter ces 
notions au fil de la lecture de cet ouvrage. 



Remarque 

Ces termes ne sont pas classes par ordre alphabetique mais par niveau de complexity afin de faciliter leur lecture. 
Projet 

Avec Flash Professionnel 8, il est possible de regrouper plusieurs elements Flash (documents 
d'animation FLA, fichiers AS externes. . .) au sein d'une meme entite nommee projet. 

Identifiants 

On appelle « identifiants » les noms des differents elements de Flash (variables, objets, fonctions, 
proprietes ou methodes). Les caracteres utilises pour construire un identifiant peuvent etre une lettre, 
un chiffre ou un trait de soulignement. Le premier caractere ne doit jamais etre un chiffre. 

Variables 

On appelle « variables » les identifiants qui contiennent des valeurs (quel que soit leur type : booleen, 
numerique ou chaines de caracteres). Les variables permettent de memoriser des valeurs afin de les 
exploiter plus tard dans le programme. Une variable doit etre prealablement declaree (et eventuel- 
lement initialisee) avant de pouvoir etre utilisee (par exemple : var nomVar:Numeric;). Laffectation 
consiste a attribuer une valeur a une variable (par exemple : nomVar=15;). 
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Les champs « texte de saisie » ou « dynamiques » possedent une variable qu'il est possible de 
nommer en renseignant le champ Var dans le panneau des proprietes. Si vous nommez la variable 
d'un champ texte nomVar, vous pourrez ensuite acceder a sa valeur de la meme maniere qu'avec une 
variable traditionnelle. 



A noter 

Le concept objet applique aux champs texte permet aussi d'acceder a la valeur d'une variable en utilisant la 
propriete text appliquee au nom de I'occurrence du champ texte concerne. Ainsi, si I'occurrence d'un champ 
texte est nomVar_txt, il est possible d'acceder a sa valeur en utilisant nomVar_txt.text. 

Constantes 

On appelle « constantes » les identifiants qui contiennent des valeurs qui ne peuvent pas etre modifiees. 
En general, les noms des constantes sont en majuscules (exemple : SPACE, BACKSPACE...). 



Les mots-cles sont des mots reserves avec une signification particuliere en ActionScript. Par exemple, 
var est un mot-cle utilise pour declarer des variables locales. Vous ne pouvez pas utiliser le mot- 
cle var comme identifiant d'un element de Flash (variable, objet, fonction...). 



Avec les actions (ou instructions), l'utilisateur devient un acteur : il peut interagir avec Fanimation a 
l'aide du clavier ou de la souris de son ordinateur. Nous parlerons done d' animation interactive. Cette 
interactivite est possible grace aux actions (pour un ensemble d'actions, nous utiliserons aussi le 
terme « script »). Une action est une instruction qui ordonne a Flash Player d'executer une operation 
specifique lors de sa lecture. 



Un script (appele aussi « bloc d'actions ») est un jeu d'actions ActionScript qui s'execute lorsqu'un 
evenement particulier survient. Les scripts peuvent etre places a deux endroits differents : dans une 
image cle ou sur un clip (ou un bouton). Dans le deuxieme cas, il faut utiliser un gestionnaire 
d'evenements pour definir quel evenement declenchera le script. 

Compilation 

Dans Flash, le moment ou vous publiez, exportez, testez ou deboguez votre document Flash est 
appele « compilation ». Le document FLA est alors transforme en un document SWF qui pourra etre 
interprete par Flash Player. 



Mots-cles 



Action 



Script 



Execution 



Dans Flash, le moment ou votre script s'execute dans Flash Player est appele execution. 
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Evenement 

Les evenements sont des actions qui se produisent lors de la lecture d'un fichier SWF. La detection 
d'un evenement permet de lancer un script particulier lors de la lecture d'une animation. Differents 
types d' evenements peuvent declencher un script : par exemple la tete de lecture atteint une image 
specifique ou l'utilisateur utilise sa souris ou son clavier pour interagir sur l'animation (en cliquant 
sur un bouton ou en appuyant sur une touche particuliere, par exemple) ou encore un clip ou un 
fichier externe est charge. 

Gestionnaire d'evenements 

Si vous desirez declencher une action a partir d'un bouton ou d'un clip, vous devrez utiliser un 
gestionnaire d'evenements afin de preciser quel evenement doit declencher le script et pour delimiter 
le jeu d'instructions qui correspond aux actions generees. Dans le gestionnaire, le jeu d' instructions 
est delimite par des accolades { et }. On distingue les gestionnaires d'evenements de souris (on( )) et 
les gestionnaires d'evenements de clip (onCl ipEvent( )). 

Methode de gestionnaire d'evenements 

Comme les gestionnaires d'evenements, les methodes de gestionnaire d'evenements permettent de 
programmer le declenchement d'une action a partir d'un evenement specifique. Contrairement aux 
gestionnaires classiques, qui doivent etre places sur un clip ou sur un bouton specifique, les methodes 
sont directement integrees dans une image cle de l'animation. Ce mode de programmation a 
l'enorme avantage de centraliser tous les scripts de gestion d' evenement en un point unique. II 
permet en outre d'appliquer des gestions d'evenement a d'autres objets que le clip ou le bouton 
(comme l'objet son, l'objet LoadVars, l'objet Xml, etc.). 

Fonctions 

Les fonctions sont des blocs d'actions declares au prealable et reutilisables a differents endroits d'un 
programme. Pour declarer une fonction, il faut utiliser le mot-cle function (exemple : function 
nomFonction( ) { //bloc d'actions }). Pour utiliser une fonction apres F avoir declaree, il suffit de la 
nommer dans une instruction. La valeur resultat sera retournee a la place du nom de la fonction 
(exemple : monResultat=nomFonction( ) ;). Dans certains cas, il est possible de passer des parametres 
(valeurs ou variables de tout type) en argument (entre les parentheses de la fonction) afin de person- 
naliser l'appel de la fonction (exemple : monResul tat=nomFonction(23, "bonjour") ;). 

Objets 

Les objets sont des entites regroupant des proprietes (attributs de l'objet) et des methodes (taches 
specifiques a l'objet). L'objet nait lorsque Ton cree une occurrence d'une classe particuliere. On 
distingue les objets issus d'une classe Flash integree (presentes dans ce meme chapitre) et les objets 
issus d'une classe personnalisee (la classe personnalisee doit etre declaree au prealable dans un 
fichier externe. Ce second type d'objets est presente dans le chapitre 14 dedie a la programmation 
orientee objet). 
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Proprietes 

Les proprietes sont des attributs qui definissent un objet. Par exemple, .visible est une propriete de 
tous les objets de la classe MovieCl ip qui definit si ceux-ci sont visibles ou masques. Pour manipuler 
une propriete, vous devez rappeler l'identifiant de l'objet concerne, suivi d'un point et du nom de la 
propriete (par exemple, F instruction suivante permet de rendre invisible un objet de la classe 
MovieCl ip : monCl ip_mc._vi sible=fal se;). 



A noter 

Les noms des proprietes issues des precedentes versions de Flash sont precedes d'un caractere de souli- 
gnement (_) mais depuis Flash MX les noms des proprietes ne suivent plus cette convention de nommage 
(exemple : length). 



Methodes 

Les methodes sont des taches qui peuvent etre realisees par un objet. Ce sont en quelque sorte des 
fonctions attachees a chaque classe et dont leurs occurrences (les objets) heritent. Pour appeler une 
methode, il faut rappeler l'identifiant de l'objet concerne, suivi d'un point, du nom de la methode et 
de deux parentheses (exemple : l'appel de la methode suivante permet de trier les elements d'un objet 
de la classe Array : monObjet_array . sort( ) ;) 

Occurrence 

Les occurrences sont des objets qui appartiennent a une certaine classe. Chaque occurrence d'une 
classe herite de toutes les proprietes et des methodes de cette classe. Par exemple, comme tous les 
clips sont des occurrences de la classe MovieCl ip, vous pouvez utiliser n'importe quelle methode 
ou propriete de la classe MovieCl ip avec n'importe quelle occurrence de clip. 

Nom d'occurrence 

Les noms d'occurrence sont des noms uniques attribues a chaque objet d'une animation et qui 
permettent de les cibler. Si l'objet est genere dynamiquement (par le programme), 1' instruction de 
creation doit definir son nom d'occurrence. Si l'objet est cree sur la scene, il faut utiliser l'inspecteur 
des proprietes pour lui affecter un nom. 

Classe 

Comme nous venons de le voir, la classe donne naissance a un objet lors de la creation d'une occur- 
rence. II existe des classes d'objets integres predennies dans le langage ActionScript, mais vous 
pouvez creer vos propres classes utilisateur. Pour creer une nouvelle classe utilisateur, utilisez le mot- 
cle cl ass dans un fichier de script externe portant le meme nom que la classe creee. 

Chemins 

Les chemins sont les adresses hierarchiques des noms de variables ou d'objets (appelees aussi 
« chemin cible »). Les differents elements d'un chemin sont separes par un point. Le scenario 
principal (qui porte le nom _root) sert de point de reference aux chemins absolus (exemple : 
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_root.monCl ipl.maVan'able). Vous pouvez utiliser un chemin cible (on appelle aussi cela referencer 
un element) pour appeler une methode d'un objet ou pour manipuler la valeur d'une variable 
(exemple : _root .monTabl eau_array . sort( ) ou _root .monCl ip.maVari abl e=40;). 



Syntaxe et elements fondamentaux d'ActionScript 

Regies d'ecriture 

Les identifiants utilises en ActionScript doivent repondre a certaines contraintes. Vous trouverez ci- 
apres quelques regies a suivre pour respecter ces contraintes. 

Les mots-cles interdits 

Les noms des differents elements de Flash (variables, objets, fonctions...) ne doivent comporter que 
des caracteres alphanumeriques ou le caractere souligne_ mais jamais d'espace. 

II est egalement interdit d'utiliser des mots-cles pour eviter les erreurs d'interpretation de code. Les 
mots-cles specifiques a FActionScript suivants ne devront jamais etre utilises comme noms de 
variable : 

break, case, class, continue, default, delete, do, dynamic, else, extends, finally, for, 
function, get, if, implements, import, interface, in, instancef, new, null, private, public, 
return, static, switch, this, throw, try, typeof, undefined, var, void, while, with 

Les identifiants sont sensibles a la casse 

Depuis ActionScript 2.0, les noms des elements sont sensibles a la casse. Une variable nommee 
nomVariable sera differente de la variable NomVariable ou encore de nomvariable. 



Convention de nommage 

Dans cet ouvrage, nous utiliserons les minuscules pour les identifiants, sauf si deux noms sont conca- 
tenes pour former l'identifiant. Dans ce cas, la premiere lettre du second nom sera une majuscule 
(nomVar, par exemple). Utilisez des noms explicites afin de les memoriser sans peine et de les identifier 
facilement (exemple: totalPrix, nomUtilisateur, fichierData...). 

Prefixe des identifiants d'elements globaux 

Nous utiliserons le prefixe glob_ devant 1'identifiant d'un element global afin d' eviter les conflits 
entre un element global et un element local de meme nom. Pour declarer globalement la variable 
maVariable, attribuez-lui l'identifiant glob_maVariable. 

Suffixes des identifiants d'objet 

Macromedia recommande l'utilisation de suffixes dans le nommage des identifiants de chaque objet 
(exemple : il faut ajouter le suffixe _1 v au nom d'un objet LoadVars, soit monEnvoi_l v). Flash detecte 
le type d'element lors de la saisie de cet identifiant dans Fediteur ActionScript et affiche un conseil de 
code en rapport (une infobulle contenant la syntaxe complete de Faction en cours ou un menu contextuel 
repertoriant des noms de proprietes ou de methodes utilisables pour le type d'objet concerne). 
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Dans le cas ou l'objet est cree sur la scene (MovieCl ip, Button, Champ texte), vous devez saisir 
l'identifiant avec son suffixe (monCl ip__mc par exemple) dans le champ du nom d'occurrence du 
panneau des proprietes. 



Tableau 7-1. Suffixes recommandes par Macromedia 



Type d'element 


Suffixe a ajouter a l'identifiant de I'element 


Array 


_array 


Button 


_btn 


Camera 


_cam 


Color 


_color 


ContextMenu 


_cm 


ContextMenultem 


_cmi 


Date 


_date 


Error 


_err 


LoadVars 


_lv 


LocalConnection 


Jc 


Microphone 


_mic 


MovieClip 


_mc 


MovieClipLoader 


_mcl 


PrintJob 


_pj 


NetConnection 


_nc 


NetStream 


_ns 


SharedObject 


_so 


Sound 


_sound 


String 


_str 


TexrField 


_txt 


Test Format 


_fmt 


Video 


_video 


XML 


_xml 


XMLNode 


_xml node 


XMLSocket 


_xml socket 



Principaux symboles de la syntaxe ActionScript 

Comme dans tous les langages, certaines contraintes d'ecriture doivent etre respectees afin que 
l'interpreteur du langage puisse analyser puis executer les instructions demandees. Ces contraintes 
definissent des regies de structure et de syntaxe que vous devez connaitre pour realiser un programme 
operationnel. Afin de vous initier a l'ecriture de scripts, nous vous presentons ci-apres les principaux 
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symboles utilises en ActionScript ainsi que le contexte dans lequel ils sont utilises pour encadrer 
les instructions et structurer les programmes. Nous etudierons ensuite les differents elements qui 
constituent les instructions. 

Le point-virgule pour cloturer une instruction 

L'instruction est F element de base de tout programme. Une instruction est constituee d'une expres- 
sion, elle-meme constituee de mots-cles et d'operateurs, et se termine par un point-virgule. Toutefois, 
contrairement au PHP pour lequel le point-virgule est obligatoire, Flash accepte les expressions sans 
cette ponctuation. Nous vous conseillons toutefois de l'ajouter a la fin de toutes vos instructions, ne 
serait-ce que pour contribuer a la bonne lisibilite de vos programmes. 

Exemples d' instructions : 

monAccueil ="Bonjour" ;// Instruction d' affectation d'une valeur "Bonjour" a une variable 
^nominee monAccueil 

gotoAnPlay(l);// Fonction de controle du scenario (renvoie la tete de lecture a l'image cle 1) 

Les accolades pour delimiter un bloc d'actions 

Dans les programmes ActionScript, il est souvent necessaire de regrouper une serie d'actions 
(instructions) dont F execution a ete prealablement conditionnee par une expression entre parentheses 
(test d'un evenement, expression de condition, expression de boucle...). On utilise les accolades pour 
delimiter le debut et la fin de la serie d'instructions. L' ensemble ainsi balise s'appelle un bloc. 

Exemples : 

// Exemple de bloc utilise avec un gestionnaire d'evenements 
on (release) { 

monAccueil ="Bonjour";// Premiere ligne du bloc 

memo=true;// Derniere ligne du bloc 

} 

// Exemple de bloc utilise avec une structure de condition 
if (x>4) { 

monAccueil ="Bonjour" ;// Premiere ligne du bloc 
memo=true;// Derniere ligne du bloc 

} 

// Exemple de bloc utilise avec une structure de boucle 
for (x=0;x<5;x++) { 

monAccueil ="Bonjour" ;// Premiere ligne du bloc 

memo=true;// Derniere ligne du bloc 

} 

Des blocs sont parfois imbriques pour les besoins du programme : 

// Exemple de blocs imbriques 
for (x=0;x<5;x++) {// Debut du bloc principal 
if (x>4) { 

monAccueil ="Bonjour" ; // Premiere ligne du bloc 
memo=true;// Derniere ligne du bloc 

} 

el se { 



ActionScript, les bases du langage 

Chapitre 7 



monAccueil="Bonsoir";// Premiere ligne du bloc 
memo=false;// Derniere ligne du bloc 

} 

}//fin du bloc principal 



A noter 

Les accolades sont egalement utilisees pour delimiter les differentes actions qui doivent etre executees lors de 
I'appel d'une fonction utilisateur comme dans I'exemple ci-dessous. 
maFonction=function( ) { 
trace( "bonjour a tous"); 

} 



Rappel 

Les variables locales declarees en debut d'un bloc expirent a la fin de celui-ci. Une variable locale ne peut done 
etre manipulee que dans son propre bloc. Si vous desirez augmenter la portee d'une variable, il faut la declarer en 
tant que variable globale. 



Le point pour lier les elements d'un chemin 

Le point est frequemment utilise en programmation objet et en ActionScript 2.0. On nomme cette 
technique « syntaxe pointee » (pour la distinguer de la « syntaxe a barre oblique » utilisee dans les 
anciennes versions de Flash). Le point permet de lier les differents objets ou proprietes pour elaborer 
un chemin qui permettra d'acceder un element specifique. Le chemin ainsi elabore est representatif 
de la hierarchie des differents elements. 

Voici un exemple de chemin pointant vers une variable maVar d'un clip monCl i p2, lui-meme place sur 
monCl i pi (utilise avec les anciennes versions 3, 4 et 5 de Flash) : 

monCl ipl/monClip2:maVar 

Avec Flash 8, tous les chemins doivent etre constitues d'elements lies exclusivement par des points. 
Voici un exemple equivalent au precedent (a utiliser avec Flash 8 ou ulterieur) : 

monCl i pi. monCl ip2. ma Var 

La syntaxe pointee utilise egalement deux alias speciaux, _root et _parent. Lalias _root fait refe- 
rence au scenario principal. Vous pouvez l'utiliser pour creer un chemin cible absolu. Linstruction 
suivante appelle la fonction maFonction( ) situee dans le clip monCl ip_mc du scenario principal : 

_root. monCl ip_mc.maFonction( ) ; 

Vous pouvez utiliser F alias _parent pour faire reference a un clip dans lequel est imbrique l'objet 
courant ou pour creer un chemin cible relatif. Par exemple, si le clip monCl i pl_mc est imbrique dans le 
clip monCl i p2_mc, l'instruction suivante, placee dans l'occurrence monCl i pl_mc, indique a monCl i p2_mc 
de s'arreter : 

| _parent.stop( ) ; 
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Les crochets pour acceder au contenu des tableaux 

Les crochets ([ et ]) permettent d'encadrer l'indice d'un element de tableau et d'acceder facilement 
a sa valeur. Par exemple, si vous desirez acceder a Felement d'indice 2 du tableau monTabl eau_array, 
il faut utiliser la ligne de code suivante : 

MonTabl eau_array[2] 

II est ainsi possible de manipuler facilement les valeurs des tableaux pour les modifier, les copier ou 
les supprimer. 

Exemples : 

maVar=monTableau_array[2] ;// Copie de la valeur de 1 'element d'indice 2 du tableau monTableau 
*»dans la variable maVar 

monTableau_array[3]="Bonjour" ;// Mise a jour de la valeur d'indice 3 du tableau monTableau 
*»avec la chaine de caracteres "Bonjour" 

Les crochets sont aussi utilises pour evaluer une expression avant qu'elle ne soit interpretee. 

Exemples : 

_root[nomBouton+"_btn"] .onRelease ;// L'expression ci-contre sera evaluee avant d'etre 
^♦interpretee. Ainsi, si la variable nomBouton est egale a rouge, l'expression finalement 
^interpretee sera la suivante : 
_root . rouge_btn . onRel ease ; 

_root[nomFonction] ( ) ; // De meme, il est possible d'appeler dynamiquement une fonction selon 
*»la valeur d'une variable (nomFonction dans l'exemple). Ainsi, si cette variable est egale a 
*»calculMoyenne, alors l'expression finalement interpretee sera la suivante et c'est la 
*»fonction du meme nom qui sera executee : 
_root.calculMoyenne( ) ; 

Dans les exemples precedents, nous avons utilise le mot-cle _root[_] car les elements concernes 
(bouton et fonction) se trouvaient sur le scenario principal _root mais il est egalement possible 
d'utiliser_parent[...] thi s [...] ou nomCl ip[...], selon l'emplacement de Felement a appeler. 

Les parentheses pour encadrer les parametres 

Les noms des actions, des methodes ou des fonctions sont frequemment suivis d'une parenthese 
ouvrante et d'une parenthese fermante (exemple : maFonction( )). II est quelquefois necessaire de les 
personnaliser a l'aide de parametres passes en argument. Ces parametres sont alors ajoutes entre 
les parentheses. Si plusieurs parametres doivent etre transmis, ils seront separes par des virgules. 

Exemples : 

maFonctionO ; // Appel d'une fonction sans parametre 

maFonction(parametrel ,parametre2) ; // Appel d'une fonction avec passage de deux parametres 
gotoAnPlay(l) ;// Appel de Taction gotoAnPlay(l) avec passage du parametre 1 en argument 
**(dans ce cas, le parametre precise le numero de 1 'image cle sur laquelle doit se caler la 
*»tete de lecture) 

monClipl_mc.duplicateMovieClip("monClip2_mc");// Dans cet exemple, le nom du clip a creer 
*»(monClip2) est passe en parametre lors de 1 'appel de la methode dupl icateMovieCl ip( ) 



ActionScript, les bases du langage 

Chapitre 7 



Les guillemets pour declarer des chaines de caracteres 

Les variables peuvent etre de differents types : numerique, booleens ou chaine de caracteres. Lorsque 
Ton affecte une valeur de type chaine de caracteres a une variable, il faut l'encadrer par des guille- 
mets (simples ou doubles). A l'inverse, si Ton affecte une valeur numerique a une variable, il ne faut 
pas utiliser de guillemets, sinon le nombre sera enregistre comme une suite de caracteres et non 
comme une valeur numerique. 

Exemples : 

maVar= "Bonjour";// Une chaine de caracteres doit etre encadree par des guillemets lors de 

**son affectation a une variable 

monScore= 32;// Dans le cas d'une valeur numerique, il ne faut pas utiliser de guillemets 

Deux barres obliques pour commenter une simple ligne 

Dans un script ActionScript, il est possible de commenter le code en utilisant deux syntaxes differentes 
selon qu'il s'agit d'une simple ligne ou d'un ensemble de lignes. 

Si on desire inserer un simple commentaire sur une ligne ou a la fin d'une instruction, il faut ecrire 
deux barres obliques // devant celui-ci : 

Rond_mc. rotation = 90 ; // Ici c'est un commentaire en bout de ligne 
// Ici c'est un commentaire sur une ligne complete 

La barre oblique et I'asterisque pour les commentaires multilignes 

Si on desire ecrire plusieurs lignes de commentaire, il faut employer /* au debut de la zone de 
commentaire et */ a la fin de celle-ci : 

/* 

ceci est un commentaire 
sur plusieurs 
1 ignes 
*/ 

Utiliser les commentaires pour deboguer 

Comme avec le PHP, en ActionScript vous pouvez utiliser les commentaires pour neutraliser une 
ligne ou un bloc de code. Cela permet de tester un script sans interpreter la partie neutralisee et 
d' identifier la partie du code qui produit l'erreur. 



Les variables et les constantes 

Les variables permettent de memoriser une information en lui affectant une valeur afin de 1' exploiter 
dans la suite du script. Par exemple, si vous desirez memoriser le score d'un joueur, vous l'affecterez 
a une variable scoreJoueurl pour pouvoir ensuite le comparer avec le score des autres joueurs. 
Cependant avant d'utiliser une variable, il faut la declarer soit grace a une simple affectation initiale 
(comme c'etait souvent le cas en ActionScript 1.0 ; le type de la variable est alors celui de la valeur 
affectee), soit en utilisant la syntaxe du typage strict (solution conseillee si vous utilisez 
ActionScript 2.0) grace a laquelle le type de la variable est explicitement indique. 
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Declaration et typage des variables 

Les variables peuvent etre de differents types selon les valeurs que Ton desire leur affecter (nombre, 
texte, booleen...). Contrairement au PHP, avec ActionScript, le type de la variable n'est pas modifie 
automatiquement si on lui affecte une valeur d'un autre type. Par exemple, si le texte "30" (et non le 
nombre 30) a ete affecte a une variable, il est impossible de lui appliquer une operation arithmetique 
sans l'avoir au prealable transforme (a Faide de la fonction NumberO, par exemple). II est done 
primordial de bien definir le type de chaque variable et de veiller par la suite a ne leur affecter que des 
valeurs de meme type au cours de 1' animation. 



La fonction trace() 

L'instruction traceO est souvent utilisee pour deboguer les programmes ActionScript. Elle permet d'atficher le 
resultat obtenu dans le panneau Sortie lors du test de I'animation. Les fonctions de ce type seront traitees a la fin 
de ce chapitre, mais il est interessant de connaitre des maintenant la syntaxe de cette fonction afin de pouvoir 
Interpreter et I'utiliser dans les scripts des exemples ci-dessous. 
Syntaxe : 

tracetvaleur oil variable a afficher); 
Exemples : 

trace( "bonjour" ) ; // Affiche le mot "Bonjour" dans le panneau Sortie 
nomVar="Def ranee" ; 

trace(nomVar) ; // Affiche "Oefrance" dans le panneau Sortie 

trace( "bonjour M. "+nomVar) ; // Affiche "bonjour M.Defrance" dans le panneau Sortie 

L'affectation d'une variable 

Les variables sont des conteneurs dont le contenu (la valeur) peut etre modifie. Pour modifier une 
valeur de variable, il suffit d'indiquer son identifiant, suivi d'un signe egal (=) et de la valeur que Ton 
desire lui attribuer. Cette operation s'appelle 1' affectation. 

Exemple : 

nomVar = 54 ; 

// Dans ce cas la valeur numerique 54 est affectee a la variable nomVar 
L'initialisation 

II est toujours judicieux d'affecter une valeur connue a une variable que vous definissez pour la 
premiere fois. En pratique, cette operation, appelee initialisation, est souvent effectuee dans la premiere 
image cle de I'animation. 

Exemple de script d' initialisation place dans F image 1 du scenario principal : 

nomVarl = 30 ; 
nomVar2 = "bonjour" ; 
nomVar3 = true ; 

Le typage automatique par affectation 

La simple initialisation d'une variable (celle que Ton a coutume d'utiliser en ActionScript 1.0) 
permet d' attribuer automatiquement a celle-ci un type qui sera celui de la valeur affectee. Ainsi, il 
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suffit d'affecter une valeur a une variable pour la declarer et lui attribuer automatiquement le type de 
cette valeur : 

nomVar = 30 ; // Dans ce cas, la variable sera de type numerique (Number) 

Pour affecter une chaine de caracteres a une variable (et du meme coup lui attribuer le type String), 
il suffit d'encadrer le texte par des guillemets (simples ou doubles) : 

nomVar="Maurice Dupond"; // Dans ce cas la variable sera de type texte (String) 

Pour affecter un nombre a une variable (et du meme coup lui attribuer le type Number), il faut saisir ce 
nombre sans guillemet : 

nomVar=100; // Dans ce cas la variable sera de type numerique (Number) 
A noter 

Si vous affectez la valeur 30 a une variable, il s'agit alors d'une chaine de caracteres et non d'un nombre. 
Par consequent, le type de la variable sera Stri ng et non Number. 

nomVar = "30"; // Dans ce cas la variable sera de type texte (String) 



Le typage strict 
Declaration 

En ActionScript 2.0, une variable peut etre declaree et typee en utilisant une syntaxe specifique 
constituee du mot-cle var et du caractere « : » suivi du type de la variable (String, Number, Boolean). 
On parle alors de typage strict des donnees. 

Exemple : 

var nomVar: Number ; 

// Declaration d'une variable "nomVar" de type numerique 
Declaration et initialisation 

Le typage strict des donnees permet d'initialiser la variable en ajoutant, a la suite de l'instruction de 
declaration, un signe egal (=) suivi de la valeur a appliquer : 

var nomVar: Number = 30 ; // Declaration et initialisation avec la valeur 30 d'une variable 
^•"nomVar" de type numerique 

On peut ainsi declarer et initialiser tout type de variable (String, Number, Boolean...) : 

var nomVarl :String = "Jean Dupond" ; // Declaration et initialisation avec la valeur "Jean 
^♦Dupond" d'une variable "nomVarl" de type chaine de caracteres. 

var nomVar2:String = nomVarl ; // Declaration et initialisation avec la valeur de la variable 
*»"nomVarl" de type chaine de caracteres. 

II est egalement possible de declarer une nouvelle variable dont la valeur sera issue de la concatenation 
(a Faide de l'operateur +) de plusieurs textes et/ou variables de meme type : 

var nomVar3:String = nomVarl + " Monsieur "+ nomVar2 ; // Declaration et initialisation avec 
^•concatenation d'une variable "nomVar3" de type chaine de caracteres. Le resultat de nomVar3 
**sera "Bonjour Monsieur Jean Dupond". 
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Attention ! 

Si vous concatenez des variables de type texte, les textes seront colles les uns aux autres alors que si vous ajoutez 
des variables de type numerique, le resultat sera egal a I'addition arithmetique de leur valeur. Si dans les elements 
concatenes se trouve au moins une valeur de type texte, le resultat final sera de type texte, meme si toutes les 
autres valeurs sont de type numerique) : 

var nomVar4: Number = 10 ; // Declaration et initialisation d'une variable 

"nomVar4" de type numerique. 

var nomVar5:Number = nomVar4 + 20 ; // Declaration et initialisation avec 
concatenation d'une variable "nomVar5" de type numerique. La valeur 
d'initialisation de la variable nomVar5 sera alors egale a 30. 



A noter 

Le typage strict des donnees permet aussi de creer tout type d'objet (Array, MovieCl ip, Sound...). Dans ce cas, 
on utilise le mot-cle new et une syntaxe differente. Nous detaillerons I'utilisation et la creation des differents objets 
Flash dans la section suivante. 

var nomVar:Array = new ArrayO ; // Declaration et initialisation d'une variable 

"nomVar4" de type numerique. 



Declarer les variables en debut de scenario 

Meme si vous pouvez manipuler une variable (c'est-a-dire modifier ou recuperer sa valeur) depuis 
n'importe quel scenario en utilisant le chemin cible adapte, comme dans Fexemple suivant, nous 
vous conseillons de declarer vos variables dans le scenario dont elles dependent : 

_root .monCl ip_mc.maVariabl e ="bonjour" ; 

// Ciblage d'une variable declaree initialement dans le scenario monClip_mc 

En effet, il n'est pas possible d'utiliser le mot-cle var devant un chemin cible referencant une variable 
situee dans un autre scenario : 

var _root.monCl ip_mc.maVariabl e: Strings "bon jour" ; 
// Attention, cette syntaxe n'est pas autorisee 

En pratique, il est judicieux de declarer toutes les variables d'un meme scenario dans la premiere 
image cle de celui-ci. Cela permet, d'une part, d'utiliser le typage strict et de beneficier de ses avan- 
tages et facilite, d' autre pail, la lisibilite du programme (toutes les declarations de variables sont 
regroupees). 

Avantages du typage strict 

Meme si le typage strict est plus complique a mettre en ceuvre, il permet a Flash de reconnaitre auto- 
matiquement le type de chaque donnee et de vous assister dans votre redaction. 

A noter 

Cette assistance a la redaction peut aussi etre activee par I'ajout d'un suffixe au nom des elements (_mc , _btn , 
_txt...) en rapport avec leur type (pour plusde details sur les suffixes de nom d'element, revoir le tableau 7-1. 
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Les incompatibilites de type de donnees sont souvent a l'origine d'eiTeurs de compilation. Le typage 
strict evite d' affecter une valeur dont le type est incorrect par rapport a celui defini lors de la declara- 
tion de la variable (pour tester la compatibilite des types, utilisez le bouton Verifier la syntaxe depuis 
le panneau Actions). 

Le typage strict permet egalement d'optimiser l'espace de la memoire reserve a chaque variable arm 
d' exploiter au mieux les ressources de l'ordinateur client. 

II ameliore les performances de vos scripts car lorsque Flash connait le type des donnees, il peut 
anticiper ses actions. 

Macromedia conseille d'utiliser le typage strict des variables dans tous les scripts. Nous vous invitons a 
suivre ce conseil si vous voulez realiser des programmes performants. 

Differences entre ActionScript 1.0 et 2.0 

Avec ActionScript 1 .0, il etait d'usage d'initialiser une variable sans preciser son type : 
nomVar = 30 ; 

ActionScript 2.0 introduit le typage strict des donnees et suggere d'utiliser le mot-cle var et d'indiquer le type de 
variable (Number, String, Boolean...) dans la declaration (meme si ('initialisation simple esttoujours possible) : 
var nomVar:Number = 30 ; 



Tableau 7-2. Les variables ActionScript peuvent prendre differents types 
selon le mot-cle utilise lors de leur declaration 

Mot-cle Typede Description Exemples 
variable 

String Chaine de 
caracteres 



Number Valeurs 

numeriques 



// Uti 1 i sation 

prixTotal= prixArticle+ nbArticle; 



Leurs valeurs sont des lettres, des chiffres // Decl a rati on 

ou des symboles. Pour affecter un texte V ar maRue:String="5 rue d'Alesia"; 

(valeur alphanumerique) a une variable, var maM ai son : String="vi 1 1 a \"Le bleuet\" "; 

vous devez I'encadrer par des guillemets. „.,, c . . „ n . „ 

r a var mavme:Str1ng= Paris ; 
Si vous placez des chiffres entre guille- . . . ,, c „, 

., . , var monCode:Stnng= 75014 ; 

mets, lis seront enregistres en tant que 

texte etnoncomme une valeur numerique. var ^Adresse: String; 

Si vous devez integrer des guillemets 11 Utilisation 

dans la chaine, II faut les faire preceder du monAdresse="5 rue d'Alesia" + "Paris" + "75014" ; 

caractere d'echappement \. //la variable ci-dessous est identique a la 

Si vous devez assembler plusieurs chai- variable precedente 

nes de caracteres, vous pouvez utiliser monAdresse= maRue + monCode + maVille; 

I'operateur d'addition +. 

II est egalement possible d'assembler des 

variables prealablement initialisees. 

Leurs valeurs sont des nombres (entiers // Declaration 

ou decimaux). Pour affecter un nombre a var prixArticle:Number=70; 

une variable, II ne doit pas etre encadre var nb Article:Number=2; 

par des quillemets, sinon il faudra le . T . , ., 

r , , var prixlotal :Number; 

convertir a I aide de lafonction Numbert ). 
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Tableau 7-2. Les variables ActionScript peuvent prendre differents types 
selon le mot-cle utilise lors de leur declaration (suite) 



Mot-cle 



Type de 
variable 



Description 



Exemples 




Bool ean 



Booleens 



Leurs valeurs sont soit true (vrai), soit 
false (faux). Ce type de variable peut 
etre utilise a la place d'une expression de 
condition (voir exemple ci-contre). 



I/ Declaration 

var etatDrapeau:Boolean=true; 
var interMusi que: Bool ean=false; 
II util isation 

etatDrapeau:Boolean=false;//modif etat variable 
if (etatDrapeau) {...} 



A noter : de nombreuses proprietes d'objet 
sont des variables booleennes (_visible...). 
La valeur f al se peut aussi etre le chiffre 
0 et la valeur true le chiffre 1. 



Variable numerique PHP et ActionScript 

En PHP, il existe plusieurs types de variable numerique (entier, decimale, double precision) alors qu'en Action- 
Script, il n'en existe qu'un type. Par defaut, il correspond au type le plus precis et pourra done etre employe dans 
tous les cas de figure. 



Comment connaitre le type d'un element ? 

En cours de developpement, vous aurez peut-etre besoin de connaitre le type d'un element (variable, 
objet...) avant de l'exploiter. Dans ce cas, utilisez la fonction typeof (nomElement), qui retourne le 
type de l'element. En phase de mise au point d'un programme, vous pouvez integrer provisoirement 
dans votre page l'instruction suivante : trace (typeof (nomElement)) ;, qui affiche le type de la variable. 
Par exemple, l'instruction de debogage suivante : 

traceCType de mesData_lv = "+typeof(mesData_lv)); 
affiche dans le panneau Sortie le message suivant : 

Type de mesData_lv = object 

Evaluation de variable 

Comme PHP, ActionScript permet d'utiliser une variable en tant qu'identifiant d'une autre variable. 
Dans ce cas, il faut utiliser les crochets [ et ] pour delimiter l'expression qui sera prealablement 
evaluee avant que l'instruction finale ne soit executee. Les mots-cles thi s , _root , _parent ou encore 
l'identifiant d'un clip peuvent etre utilises selon que la variable ciblee se trouve dans le meme scenario ou 
dans un scenario different du script qui l'appelle. 

Exemples des differentes solutions possibles : 

monResultat = this[monIdentifiant]; 
monResultat = _root[monIdentifiant] ; 
monResultat = _parent[monIdentifiant]; 
monResultat = monClipl[monIdentifiant]; 

/* Dans les exemples ci-dessus la variable monldentifiant a pour valeur l'identifiant de la 
^variable a affecter a monResultat. 

Par exemple, si la variable monIdentifiant="monMessage" et monMessage="bonjour" , la variable 
^monResultat aura pour valeur "bonjour" apres l'une des quatre affectations.*/ 
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Dans l'exemple ci-dessous, nous allons creer une variable (monldentifiant) a laquelle nous allons affecter 
Fidentifiant d'une autre variable (monMessage) prealablement initialisee avec la valeur "bonjour". 
Nous utiliserons la syntaxe a crochets pour evaluer le nom de la variable affectee a la variable finale 
monResultat. Au terme de ce script, la variable monResultat contiendra la valeur "bonjour". 

var monMessage: Strings "bonjour" ; 
var mon Ident ifi ant: St ring= "monMessage" ; 
var monResultat = this[monIdentifiant] ; 
trace(monResultat) ;// Affiche bonjour 

Imaginez maintenant que Ton desire afficher plusieurs types de message selon une variable numeri- 
que speciflque (modifiee dans une structure de boucle, par exemple). II suffit de modifier legerement 
notre premier script pour obtenir le resultat voulu, soit le script suivant : 

var monIdentifiant:Number =0;// Init de la variable monldentifiant 
var monMessagel : St ring=" bonjour" ; 
var monMessage2:String="a bientot"; 
II 

monldentifiant =1; 

var monResultat = this["monMessage"+monIdentifiant]; 
trace(monResultat) ;// Affiche bonjour 

// 

monldentifiant =2; 

var monResultat = this["monMessage"+monIdentifiant]; 
trace(monResultat) ;// Affiche a bientot 

Les constantes 

On appelle constantes les identifiants qui contiennent des valeurs qui ne peuvent pas etre modifiees. 
En general, les noms des constantes sont en majuscules. De nombreux objets disposent de constantes 
dans leurs proprietes. Par exemple, les constantes SPACE, BACKSPACE, TAB sont des proprietes de Fobjet 
Key et font reference aux codes des differentes touches du clavier. 



Les classes d'objets integres 

Flash met a votre disposition de nombreux objets integres preconfigures. Vous avez la possibilite de 
personnaliser certains d'entre eux (voir chapitre 14). 

Les objets prets a Femploi vous permettent d'integrer rapidement differentes fonctionnalites 
evoluees dans vos animations. 

Avant de les utiliser, il faut creer une occurrence pour la plupart de ces objets. (Cette occurrence est 
aussi appelee instance. En pratique, l'occurrence de Fobjet est souvent nommee « objet ».) Pour 
illustrer ce concept, sachez que lorsque vous placez un clip sur la scene, vous creez automatiquement 
une occurrence de Fobjet originel Movi eCl i p. 

Cependant, pour la plupart des objets, il n'est pas possible de creer une occurrence par un simple glis- 
ser-deposer de Fobjet originel. II faut faire appel a la programmation en utilisant le mot-cle new suivi 
d'une fonction specifique nommee constructeur. Celle-ci reprend en general le nom de Fobjet originel 
(exemple : ColorO ou encore SoundO). 
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Une fois creees, les occurrences d'objet disposent de caracteristiques que vous pouvez personnaliser 
(en programmation orientee objet, nous ne parlerons pas de caracteristiques mais de proprietes) et de 
fonctions qui permettent de realiser des taches specifiques (en programmation orientee objet, nous ne 
parlerons pas de fonctions mais de methodes). 

Ces occurrences d'objets sont organisees en classes correspondant a des ensembles d'objets ay ant 
des proprietes et des methodes communes (les classes d'objet correspondent en quelque sorte a ce 
que nous appelions jusqu'a present Fobjet originel). Chaque occurrence d'objet appartient a une 
classe precise qui permet d'utiliser des methodes particulieres, de configurer des proprietes specifi- 
ques et quelquefois d'utiliser des constantes predefinies. Chacune peut etre personnalisee (aspect ou 
fonctionnalites differents, par exemple) tout en disposant des proprietes et des methodes propres a la 
classe dont elle est issue. 



A noter 

Pour des raisons historiques, le caractere « _ » est utilise en prefixe des noms des proprietes apparues avec 
ActionScript 1.0 (exemple : _visible, .rotation...). Les noms des proprietes plus recentes ne suivent plus 
cette convention de nommage (exemple : 1 ength, enabled...). Avec ou sans prefixe « _ », toutes les proprietes 
peuvent etre utilisees de la meme maniere. 



Voici une petite selection des nombreuses classes d'objets integres de Flash que nous avons regrou- 
pees par families afin d'illustrer le fonctionnement des classes. De meme, le nombre de methodes et 
de proprietes etant souvent tres important, nous n'en indiquons que quelques-uns a titre d'exemple. 
Si vous desirez connaitre d'autres classes ou leurs proprietes et methodes associees, consultez le 
dictionnaire ActionScript ou utilisez 1' assistant d'edition du panneau Actions (cliquez sur le bouton + 
et selectionnez Classes integrees dans les options du menu). 

Les classes des variables 

Les variables Number, Stri ng et Bool ear, que nous avons deja presentees peuvent, elles aussi, etre traitees 
comme des objets. En effet, elles disposent aussi d'une syntaxe de creation utilisant un constructeur 
qui peut etre utilisee comme solution alternative au mode de declaration deja presente. Cependant, en 
pratique le resultat etant le meme, il est rare d'utiliser le constructeur, dont la syntaxe est plus 
compliquee, pour declarer une simple variable. 

Tableau 7-3. Syntaxe de la classe Number 

Classe Number 

Permet de creer une occurrence de la classe d'objet Number equivalente a la declaration d'une variable numerique. Dans ce 
cas, la valeur d'initialisation est passee en argument dans le constructeur. 

Syntaxe de creation d'une occurrence : 

var nomVar:Number = new Number(valeur) ; 

Methodes : 

toString, valueOf 

Exemples de creation d'occurrence et d'utilisation des proprietes et des methodes : 
var prixArticle:Number = new Number(70); // Creation d'une occurrence 
var prixArticle:Number=70; // Alternative a la syntaxe precedente 
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Tableau 7-4. Syntaxe de la classe String 

Classe String 

Permet de creer une occurrence de la classe d'objet String equivalents a la declaration d'une variable chalne de caracteres. 
Dans ce cas, lavaleur du texte d'initialisation est passee entre guillemets en argument dans le constructeur. 

Syntaxe de creation d'une occurrence : 

var nomVar: String = new String(valeur) ; 

Methodes : 

concat, joint, pop, reverse, shift, slice, sort, sortOn, splice, toString, unShift 
Proprietes : 
1 ength 

Exemples de creation d'occurrence et d'utilisation des proprietes et des methodes : 
var monNom:String = new StringC'Defrance") ;// Creation d'une occurrence avec init. 
var monNom: String = "Defrance"; // Alternative a la syntaxe precedente 
trace(monNom.l ength) ; // Affiche le chiffre 8 (car la chaine comporte 8 caracteres) 
tracednonNom. concat" Jean-Marie"));// Affiche "Defrance Jean-Marie" 



Tableau 7-5. Syntaxe de la classe Boolean 

Classe Boolean 

Permet de creer une occurrence de la classe d'objet Bool ean equivalents a la declaration d'une variable booleenne. Dans ce 
cas, la valeur de I'etat d'initialisation est passee en argument dans le constr ucteur. 

Syntaxe de creation d'une occurrence : 

var nomVar:Boolean = new Bool ean(val eur) ; 

Methodes : 

toString, valueOf 

Exemples de creation d'occurrence et d'utilisation des proprietes et des methodes : 

var monEtat:Boolean = new Bool ean(true) ; // Creation d'une occurrence avec init. a true 
var monEtat:Bolean = true; // Alternative a la syntaxe precedente 
monEtat=fal se; // Force la valeur a false 

tracetmonEtat. val ueOf ( ) ) ; // Affiche false dans le panneau Sortie 

monEtat = (10<20); // A 1 'issue du test, la variable sera egale a true car 10 est inferieur a 20 
trace(monEtat.val ueOf ( ) ) ; // Affiche la nouvelle valeur, soit true, dans le panneau Sortie 



Les classes graphiques 

Lorsque vous creez un bouton, un clip ou un champ texte sur la scene par le biais de 1' interface de 
Flash, vous creez automatiquement une occurrence de ces objets. Comme tous les autres objets, ils 
possedent des proprietes et des methodes qui permettent de les controler et de les personnaliser 
(couleur, position, dimension, etc.). Nous avons regroupe ces trois objets sous le nom d'objets 
graphiques arm de les differencier des classes d'objets traditionnelles qui ne peuvent etre creees qu'a 
l'aide de leur constructeur. 
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A noter 

Ces classes graphiques ne possedent pas de constructeur car leurs occurrences sont creees en mode visuel par 
le biais de I'interface Flash (sauf pour les champs dynamiques de I'objet TextFi el d). 

Tableau 7-6. Syntaxe de la classe MovieClip 

Classe MovieClip 

La classe Movi eCl 1 p est la plus importante dans Flash car elle permet de creer des clips. 

Pour creer une occurrence de la classe d'objet MovieCl ip, vous devez utiliser I'interface visuelle de Flash (par exemple, en 
deplacant sur la scene, par un simple glisser-deposer, une occurrence d'un clip depuis la bibliotheque ou en convertissant un 
dessin en symbole de comportement clip). 

Suffixe de nom d'occurrence : 
_mc 

Exemples de methodes (liste non exhaustive) : 

AttachMovie, createEmptyMovieCl ip, dupl i cateMovieCl i p, loadMovie, gestURL, play, stop... 
Exemples de proprietes (liste non exhaustive) : 

_alpha, _rotation, _visible, _width, _height, _x, _y, menu... 
Exemples d'utilisation des proprietes et des methodes : 

/* une occurrence de la classe MovieClip nominee monClipl_mc a ete creee au prealable a l'aide de 
I'interface de Flash */ 

monCl ipl_mc._xscal e=50 ; // Diminue la largeur du clip de 50 % 

monCl ipl_mc. dupl i cateMovieCl ip( "monCl ip2_mc" ) ; // Cree un second clip nomme monClip2 
monCl ip2_mc._x=200 ; // Deplace le clip cree de 200 pixels a droite 



Tableau 7-7. Syntaxe de la classe Button 

Classe Button 

La classe Button permet de creer des boutons. Les boutons sont dotes par defaut de quatre etats predefinis qui reagissent a 
certains evenements de la souris. 

Pour creer une occurrence de la classe d'objet Button vous devez utiliser I'interface visuelle de Flash (par exemple, en depla- 
cant sur la scene, par un simple glisser-deposer, une occurrence d'un bouton depuis la bibliotheque ou en convertissant un 
dessin en symbole de comportement bouton). 

Suffixe de nom d'occurrence : 
_btn 

Methode : 
getDepth 

Exemples de proprietes (liste non exhaustive) : 

_alpha, _rotation, _visible, _width, _height, _x, _y, menu... 
Exemples d'utilisation des proprietes et des methodes : 

/* Une occurrence de la classe Button nommee monBoutonl_btn a ete creee au prealable a l'aide de 
I'interface de Flash */ 

monBoutonl_btn._alpha=20; // Regie l'alpha du bouton a 20 % 
monBoutonl_btn._rotation=45; // Positionne le bouton a 45' 
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Tableau 7-8. Syntaxe de la classe TextField 

ClasseTextField 

La classe TextFi el d permet de creer des champs texte statiques, dynamiques ou de saisie. Pour creer une occurrence de la 
classe d'objet TextFi el d, vous pouvez utiliser I'interface visuelle de Flash (par exemple, en creant un champ texte sur la scene 
en utilisant I'outil Texte) ou la methode createTextFi el d( ) pour creer un champ dynamique. 

Suffixe de nom d'occurrence : 
_txt 

Exemples de methodes (liste non exhaustive) : 

getDepth, addListener, removeListener, replaceText, setTextFormat. . . 

Exemples de proprietes (liste non exhaustive) : 

Align, height. scaleMode, showMenu, witdth... 

Exemples d'utilisation des proprietes et des methodes : 

/* Une occurrence de la classe TextField nominee monChampl_txt a ete creee sur la scene au prealable 
a 1'aide de I'interface de Flash. 

(a noter : 1'affichage de la bordure a ete valide dans le panneau Proprietes)*/ 

root. createTextFieldt "monChamp2_txt" ,0,10, 10,200,20) ; // Alternative pour creer un champ dynamiquement. 
monChamp2_txt.text="Bonjour" ; // Initialisation du texte du champ precedemment cree 
trace(monChampl_txt.text) ; // Affiche le texte du champ dans le panneau Sortie 
monChampl_txt.textColor=0x00FF00; // Change la couleur du texte du champ en vert 
monChampl_txt.backgroundColor=0x0000FF; // Modifie la couleur du fond du champ en bleu 

Les classes programmees 

Pour creer des animations interactives, Flash met a votre disposition de nombreuses classes qui 
permettent de creer dynamiquement des objets. Nous avons regroupe sous le nom de classes program- 
mees toutes celles qui donnent naissance a des occurrences en utilisant leur methode constructeur. 
Elles sont tres nombreuses et en voici une petite selection. 

Tableau 7-9. Syntaxe de la classe Array 

Classe Array 

Un objet tableau de variables (Array) permet de regrouper sous une meme etiquette une serie d'elements ayantdes liens com- 
muns. II y a deux solutions pour creer une occurrence de tableau : avec le constructeur Arrayt ) ou a I'aide de I'operateur 
d'acces tableau []. Pour acceder aux valeurs du tableau, il faut utiliser I'operateur d'acces tableau []. Les methodes de la 
classe Array permettent, entre autres, d'ajouter, de modifier ou encore de trier les elements du tableau. 

Suffixe de nom d'occurrence : 
_array 

Syntaxe de creation d'une occurrence : 

var nomTab:Array= new Array(element1 , element.2, ...); //Creation avec le constructeur 

var nomTab:Array= [elementl, element.2, ...]; // Syntaxe alternative de creation d'un tableau. 

II est egalement possible de creer un tableau vide en precisant simplement le nombre d'elements en parametre : 

var nomTab:Array= new Array(3); // Creation d'un tableau de trois element non initialises 
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Tableau 7-9. Syntaxe de la classe Array (suite) 



Exemples de methodes (liste non exhaustive) : 




concat, join, pop, push, reverse, sort, splice... 




Propriety : 




1 ength 





Exemples de creation d'occurrence et d'utilisation des proprietes et des methodes : 

var mesAmisl_array:Array= new Array( "Jean" , "Paul ", "Marie" ) ; 

// Creation avec le constructeur d'un tableau regroupant le nom d'amis 

t race (mes Ami sl_ar ray .1 ength) ; 

// Affiche le nombre d'elements du tableau (3) 

trace (mes Ami sl_a r ray .joint " , " ) ) ; 

// Affiche les differents elements du tableau separes par une virgule 
trace (mes Ami sl_array[l] ) ; 

// Affiche le deuxieme element du tableau soit "Paul" 
mesAmisl_array .push( "Al ain" ) ; 

// Ajoute au tableau un quatrieme element initialise avec la valeur "Alain" 
var monMeil leurAmi : String= mesAmisl_array[0] ; 

// Permet de copier une valeur d'un element de tableau dans une variable de type chaine de caracteres 
mesAmisl_array.sort( ) ; 

// Trie par ordre alphabetique des elements du tableau 



Tableau 7-10. Syntaxe de la classe Date 

Classe Date 

Un objet Date permet d'acceder a I'heure en cours et de specifier le jour, lasemaine, le mois ou I'annee. Pour creer une occur- 
rence de tableau, il faut utiliser le constructeur Datet ). Si aucun parametre n'est precise, I'occurrence creee renvoie I'heure du 
systeme d'exploitation sur lequel Flash Player est execute. Pour connaitre le jour, lasemaine, le mois ou I'annee en cours, il faut 
ensuite utiliser les methodes de la classe. 

Suffixe de nom d'occurrence : 
_date 

Syntaxe de creation d'une occurrence : 

var nomDate:Date= new Date (annee, mois [, date [, heure [, minute [, seconde [, milliseconde ]]]]]); 

// Creation avec le constructeur 

Seuls les parametres annee et mois sont obligatoires. 

Annee : une valeur entre 0 et 99 indique une annee entre 1 900 et 1 999. Pour les annees a partir de 2000, les quatre chiffres de 

I'annee doivent etre specifies (exemple : 2004). 

Mois : un entier compris entre 0 (Janvier) et 1 1 (decembre). 

Date : un entier compris entre 1 et 31. 

Heure : un entier compris entre 0 (minuit) et 23 (23 h 00). 

Minute : un entier compris entre 0 et 59. 

Seconde : un entier compris entre 0 et 59. 

Milliseconde : un entier compris entre 0 et 999. 

Exemples de methodes (liste non exhaustive) : 

get Date, gestFul 1 Year, get Hours, getMinutes, getMonth, set Date... 
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Tableau 7-1 0. Syntaxe de la classe Date (suite) 

Exemples de creation d'occurrence et d'utilisation des proprietes et des methodes : 
actuel 1 ement_date = new DateO; 

// Creation avec le constructeur d'une occurrence retournant 1'heure actuelle 
trace(actuellement_date.getMonth( ) + 1); 

// Affiche le numero du mois actuel (exemple : 4 + 1 = 5 pour le mois de mai) 

/* Attention, hormis les numeros des dates, du jour et des annees, les autres numeros etant incremented 
a partir du chiffre 0, il faut ajouter une unite pour compenser cette particularite (exemple pour le 
mois : getMonthO renvoie 4 done il faut faire 1 'operation 4+1 pour afficher le chiffre 5 du mois 
de mai ) . */ 

trace (actuel 1 ement_date.getDate( ) ) ; 

// Affiche le numero du jour (exemple : 25 pour le 25 mai) 
trace( actuel 1 ement_date.getFul 1 Year( ) ) ; 

// Affiche le numero de 1'annee (exemple : 2004 pour 1'annee 2004) 
dateNai ssance_date = new Date (60, 4, 18); 

// Initialise une occurrence Date avec une date precise : 18 mai 1960. 

/* Attention : pour les annees anterieures a 2000, seuls les deux derniers chiffres sont necessaires 
(exemple : 60 pour 1960) alors que pour les annees a partir de 2000, il convient de preciser quatre 
chiffres (exemple : 2004) */ 

Tableau 7-11. Syntaxe de la classe XML 

Classe XML 

Un objet XML est utilise pour charger, analyser, envoyer, construire et manipuler des arborescences de documents XML. Pour 
creer une occurrence de la classe XML, il faut utiliser le constructeur XML( ). Si aucun parametre n'est passe dans les parenthe- 
ses, I'objet sera cree vide. A I'inverse, si le document XML ou la variable dans lequel il a ete prealablement enregistre est passe 
en parametre, I'objet XML sera cree et initialise avec le document XML indique. 

Suffixe de nom d'occurrence : 
_xml 

Syntaxe de creation d'une occurrence : 

var nomXml:XML= new XML(docXml); // Creation avec le constructeur 
Exemples de methodes (liste non exhaustive) : 

appendChild, cloneNode, createElement, load, send, insertBefore, parseXML, ... 
Exemples de proprietes (liste non exhaustive) : 

attributes, childNodes, firtChild, lastChild, loaded, nextSibling, nodeName... 

Exemples de creation d'occurrence et d'utilisation des proprietes et des methodes : 

var mesEnfants_xml :XML = new XMLO; 

// Creation d'une occurrence d'objet XML vide 

var mesEnfants_xml :XML = new XML( "<root><enfant>Mel anie</enfant><enfant>Cl ai re</enf ant>" ) ; 
// Creation d'une occurrence d'objet XML avec un document XML source 
trace(mesEnfants_xml .childNodes) ; 

// Les lignes suivantes clonent le document XML et le copient dans un autre objet 
mesEnfantsCopie = new XMLO; 

copieNoeud = mesEnf ants_xml .lastChild. cloneNode(true) ; 
mesEnfantsCopie.appendChi 1 d( copieNoeud) ; 
trace(mesEnfantsCopie.chi 1 dNodes ) ; 
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Tableau 7-1 2. Syntaxe de la classe LoadVars 

Classe LoadVars 

Un objet LoadVars permet de transferer des variables entre un serveur et une application Flash. Les methodes de cette classe 
permettent, par exemple, de verifier que le chargement des donnees a reussi, d'obtenir les indications de prog ression ou encore 
les donnees de flux pendant le telechargement. Pour creer une occurrence de tableau, il faut utiliser le constructeur Load- 
Vars (). Si aucun parametre n'est passe dans les parentheses, I'objet sera cree vide (il est cependant possible par la suite de 
lui affecter des elements directement dans le code avec par exemple : mesData_l v. varl=80;). A I'inverse, si I'URL a laquelle 
se trouve le fichier a telecharger est passee en parametre, I'objet LoadVars sera cree et initialise avec les couples variable/ 
valeur du fichier source (exemple de contenu d'un fichier source : varl=lu&var2=40) . 

Suffixe de nom d'occurrence : 

Jv 

Syntaxe de creation d'une occurrence : 

var nomData : LoadVars= new LoadVars(url ) ; // Creation avec le constructeur 

Attention : le parametre de I'URL doit cibler un fichier place sur le meme domaine que le document Flash qui I'appelle (exemple : 
http://www.phpmx.eom/f ichier Data .txt si le document Flash se trouve a la racine de ce site). 

Exemples de methodes (liste non exhaustive) : 

getBytesLoaded , getBytesTotal , load, send, sendAndLoad... 

Proprietes : 

contentType, loaded 

Exemples de creation d'occurrence et d'utilisation des proprietes et des methodes : 

/* Dans l'exemple ci-dessous, on suppose qu'un fichier nomme fichierData.txt a preal abl ement ete cree 

dans le meme repertoire que le document Flash et qu'il contient les couples variables/valeurs 

suivants : 

varl=10&var2=40 

*/ 

function chargementData( ) { 

traceCok, les donnees sont chargees"); 
tracet "varl="+mesData_l v. varl) ; 
trace( "var2="+mesData_l v.var2) ; 

} 

var mesData_l v : LoadVars=new LoadVarsO; 
// Creation de I'objet mesData_lv 
mesData_l v . onLoad=chargementData ; 

// Declaration de la fonction (chargementData ) qui devra etre appelee a la fin du chargement signale 
par onLoad 

mesData_lv.load( "fichierData.txt") : 

// Utilisation de la methode load pour telecharger les donnees du fichier fichierData.txt 
/* 

Apres 1 'execution du script les informations ci-dessous seront affichees dans le panneau Sortie : 

ok, les donnees sont chargees 

varl=10 

var2=40 
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Les membres de classe 

Les membres de classe (appeles aussi membres statiques ou encore classes de haut niveau) se carac- 
terisent par le fait qu'il est impossible d'en creer une occurrence. En effet, ces classes represented et 
controlent les fonctions de haut niveau d'une animation (comme la classe Mouse, la classe Math ou 
encore la classe Stage) avec lesquelles il faut exclusivement utiliser les methodes et proprietes de la 
classe et non celles de ses occurrences (vous pouvez done acceder a ces proprietes et a ces methodes 
sans utiliser de constructeur). 

Par exemple, toutes les proprietes de la classe Math sont statiques. Si vous desirez Fexploiter pour 
connaitre le plus grand d'entre deux nombres, il vous faut utiliser la methode max( ) appliquee direc- 
tement a la classe Math : 

var MonResultat:Number = Math.max(2,4); 

Tableau 7-13. Syntaxe de la classe Mouse 

Classe Mouse 

La classe Mouse controle la visibility du curseur et per met de masquer ou d'afficher le pointeur de la souris. Vous pouvez, par 
exemple, le masquer et implementer un pointeur personnalise en le remplacant par un clip particulier comme dans Pexemple 
ci-dessous. 

Exemples de methodes (liste non exhaustive) : 
hide, addListener, removeListener, show 

Exemples d'utilisation des proprietes et des methodes (pointeur personnalise) : 

/* Dans 1 'exemple ci-dessous, on suppose qu'un clip nomme cl ipCurseur_mc a ete preal abl ement cree sur 
la scene et que le code ci-dessous a ete ajoute dans l'image 1 du scenario de ce meme clip */ 
onClipEvent (enterFrame) ( 
Mouse. hi de ( ) ; 

_root.cl ipCurseur_mc._x = _root._xmouse; 
_root.clipCurseur_mc._y = _root._ymouse; 

} 



Tableau 7-14. Syntaxe de la classe Math 

Classe Math 

Les methodes de la classe Math permettent d'effectuer de nombreux calculs. De meme, ses proprietes integrent de nombreuses 
constantes frequemment utilisees dans les formules de calcul de Flash. 

Exemples de methodes (liste non exhaustive) : 

abs, acos, asin, cos, sin, log, max, min, random, round... 

Exemples de proprietes (liste non exhaustive) : 
E, LN2, L0G2E, LOG10E, SQRT2, PI... 

Exemples d'utilisation des proprietes et des methodes : 
Math.floor(12.5); 

// Renvoie le nombre entier directement inferieur ou egal a la valeur 12,5 soit 12 
Math.pow(5, 3); 

// Renvoie le nombre 5 eleve a la puissance 3 
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Tableau 7-1 5. Syntaxe de la classe Stage 

Classe Stage 

La classe Stage permet d'acceder aux informations sur les limites d'une animation Flash et de les manipuler. Vous pouvez par 
exemple detecter le redimensionnement d'une animation par I'utilisateur afin de declencher un script specifique comme dans 
I'exemple ci-dessous. 

Methodes : 

addLi stener, removeLi stener 
Proprietes : 

al ign, height, seal eMode, showMenu, wi tdth 

Exemples d'utilisation des proprietes et des methodes (detection d'un redimensionnement) : 
monEcouteur = new Objectt); 
// Creation d'un objet d'ecoute 
monEcouteur. onResize = function () { 
// Script specifique 

// Declenche en cas de redimensionnement de 1 'animation SWF 
) 

Stage. scaleMode = "noScale"; 

// Configuration de la propriete de Stage 

Stage. add Li stener (monEcouteur) ; 

// Utilisation de la methode de Stage pour ajouter un ecouteur 

Tableau 7-1 6. Syntaxe de la classe Key 

Classe Key 

La classe Key permet de determiner I'etat des touches clavier. Vous pouvez, par exemple, detecter si une touche specifique est 
enfoncee afin de declencher un script specifique comme dans I'exemple ci-dessous. 

Exemples de methodes (liste non exhaustive) : 
addListener, removeLi stener, hide, show... 

Exemples de proprietes (liste non exhaustive) : 
BACKSPACE, ESCAPE, SPACE, TAB, CAPSLOCK... 

Exemples d'utilisation des proprietes et des methodes (detection d'une touche enfoncee) : 
if(Key.getCode() == Key. ENTER) { 

alert = "Voul ez-vous commencer 1 'animation ?"; 

controlMC.gotoAndStop(2) ; 

} 



Les operateurs 

Les operateurs permettent de lier des variables ou des expressions entre elles. Le langage Action- 
Script dispose d'un grand nombre d' operateurs et nous vous proposons d'en decouvrir quelques-uns 
que nous avons classes dans differentes families selon les fonctions realisees ou les expressions avec 
lesquelles on peut les employer (affectation, arithmetique, comparaison, logique ou de chaine). Si 
vous desirez vous informer sur les caracteristiques d'autres operateurs, reportez-vous au dictionnaire 
d'ActionScript (dans l'aide en ligne) rubrique Operateurs, oil la liste exhaustive des operateurs et de 
leurs proprietes est disponible. 
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Operateurs d 'affectation 

L'operateur d' affectation est le plus courant. On peut aussi l'utiliser sous une forme compacte integrant 
une operation arithmetique puis une affectation. 

Tableau 7-17. Operateurs d'affectation 



Symbole 


Definition 




Affectation de base 


+= 


Addition puis affectation 




Soustraction puis affectation 


*= 


Multiplication puis affectation 


/= 


Division puis affectation 



%= Modulo puis affectation 



L'operateur d'affectation de base permet d'attribuer une valeur issue d'une expression. Les autres 
operateurs d'affectation permettent en plus de realiser des operations arithmetiques d'une maniere 
tres compacte : 

maVarl=0; // Affectation de base (initialisation de maVarl a 0) 

trace( "mavarl="+maVarl) ; 

maVarl+=2; // Ici maVarl vaut 2(0+2) 

trace( "maVarl="+maVarl) ; 

maVarl+=14; // Et maintenant maVarl vaut 16 (2 + 14) 
trace( m maVarl="+maVarl) ; 

Operateurs arithmetiques 

Lorsqu'on gere des variables de type numerique, des operateurs arithmetiques permettent de realiser 
toutes les operations mathematiques standards. 

A noter 

Afin de forcer la priorite d'execution d'une operation, utilisez les parentheses pour encadrer I'expression a executer 
en premier. 

ActionScript fournit des operateurs specifiques (++ et — ) pour 1' incrementation et la decrementation 
(addition ou soustraction d'une unite), souvent utilisees en programmation. 



Tableau 7-18. Les operateurs arithmetiques permettent d'appliquer 
tout type d'operation mathematique a des variables de type numerique 



Symbole 


Definition 


+ 


Addition 


Soustraction 


/ 


Division 
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Tableau 7-18. Les operateurs arithmetiques permettent d'appliquer 
tout type d'operation mathematique a des variables de type numerique (suite) 

Multiplication 

Modulo : I'expression maVarl % 5 retourne le reste de la division de maVar par 5 
Incrementation (exemple : maVar++) 
Decrementation (exemple : maVar--) 



Voici quelques exemples : 

maVarl=5+2; // Addition de deux valeurs numeriques 

trace("maVarl="+maVarl) ; // Affiche 7 dans le panneau Sortie 

maVar2=2+maVarl ; // Addition d'une valeur numerique et d'une variable 

trace( "maVar2="+maVar2) ;//affiche 9 dans le panneau Sortie 
// 

maVar5=14; 

maVar4= maVar5M; // 14 modulo 5 est egal a 4 (14/5 = 2 et reste 4) 

trace("maVar4="+maVar4);//affiche 4 dans le panneau Sortie 
// 

maVar3=(maVar2+ maVarl)/2; 

// Utilisation des parentheses pour forcer les priorites des operateurs 
trace( "maVar3="+maVar3) ; // Affiche 8 dans le panneau Sortie 
maVar3++; // Apres cette incrementation, la variable est egale a "maVar3+l" 
trace( "maVar3="+maVar3) ; // Affiche 9 dans le panneau Sortie 



Operateurs de comparaison 

Les operateurs de comparaison sont utilises dans les expressions de condition des structures de 
programme, ou encore avec l'operateur ternaire presente ci-apres. lis permettent de comparer deux 
expressions. L' expression resultant de cette comparaison est egale a true (vrai) lorsque la condition 
a controler est verifiee ou a fal se (faux) dans le cas contraire. 

Tableau 7-19. Operateurs de comparaison 



Symbole 


Definition 


Egal 


=== Egal strict 

(la valeur et le type doivent etre identiques) 


< 


Inferieur strict 


> 


Superieur strict 


<= 


Inferieur ou egal 


>= 


Superieur ou egal 


! = Different 





Different strict 
(operateur inverse de ===) 
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L'operateur de comparaison permet d'elaborer des expressions de condition que vous pouvez utiliser 
dans les instructions de structure de programme (i f , whi 1 e, f or. . .). 

Voici quelques exemples d' utilisation d' expressions de condition : 

maVarl=5; // Initialise la variable pour le test 
maVar2=(maVarl==5) ; // Attention il y a deux signes "=" 

/* Teste si maVarl est egale a 5. Apres devaluation de cette expression de condition, la 
^variable maVar2 prend la valeur "true" dans le cas present et devient done une variable de 
*»type booleen.*/ 

trace( "n)aVar2="+ maVar2) ;//affiche maVar2=true 
// 

maVar3=(maVarl>2) // Teste 1 'expression de condition 

tracet "maVar3="+ maVar3); // Affiche maVar3=true 
II 

var naVarl:String="5"; 
var maVar2:Number=5; 
monResultat=(maVarl==maVar2) ; 
monResul tatStrict=(maVarl===maVar2) ; 

trace( "monResul tat="+monResul tat) ;/ /affiche monResul tat=t rue 
trace("monResultatStrict="+monResultatStrict) ;/ /affiche monResul tatStrict=false 
// Utilisation et comparaison d'un operateur d'egalite stricte 



Operateur ternaire 

L'operateur ternaire permet de tester rapidement une expression de condition et d'effectuer une 
action specifique selon le resultat du test. C'est une instruction tres compacte. Nous verrons plus loin 
qu'il est egalement possible d'utiliser les structures de choix (avec les instructions if et el se) pour 
realiser la meme action. Dans ce cas, la syntaxe est moins compacte. 

Tableau 7-20. Operateur de choix ternaire 

Syntaxe 

[expression de condition]?[expression effectuee si vrai ]: [expression effectuee si faux] 
Exemple: (maVarl>2)?(maVar3= »oui »):(maVar3= »non ») 
Dans le cas oil maVarl est superieure a 2, oui est affecte a maVar3, sinon c'est non. 

L'operateur ternaire permet de realiser une petite structure de choix equivalant a l'utilisation de i f et 
el se : 

mal_angue="f r" ; 

monAccueil=(maLangue=="f r" )?"bonjour" : "hel 1 o" ; 

trace( "monAccuei 1 ="+ monAccuei 1 ) ; // Affiche monAccueil = "bonjour" 
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Operateurs binaires 

Les operateurs binaires agissent au niveau du bit (0 ou 1) et non au niveau de la valeur numerique. 
lis servent a manipuler des donnees a l'aide d' operations de decalage d'un certain nombre de bits a 
droite ou a gauche et d'operateurs logiques agissant au niveau du bit. 



Tableau 7-21. Operateurs binaires 



Symbole 


Definition 


& AND au niveau du bit 


&= 


Affectation AND au niveau du bit 




XOR au niveau du bit 


a = 


Affectation XOR au niveau du bit 


OR au niveau du bit 


| = Affectation OR au niveau du bit 


NOT au niveau du bit 


« 


Decalage gauche au niveau du bit 


«= 


Decalage gauche au niveau du bit et affectation 


» 


Decalage droit au niveau du bit 


»= 


Decalage droit au niveau du bit et affectation 


»> 


Decalage droit non signe au niveau du bit 


»>= 


Decalage droit non signe au niveau du bit et affectation 



Dans l'exemple suivant, l'entier 1 est decale de 10 bits vers la gauche. 

maVarBinai re = 1 « 10 ; 

Le resultat de cette operation est maVarBinai re = 1 024. En effet, la valeur 1 en decimal est egale 
a 0000000001 en binaire. Si Ton decale cette valeur de 10 bits sur la gauche, on obtient la 
valeur 10 000 000 000, qui correspond a la valeur 1 024 en decimal. 

Operateurs logiques 

Les operateurs logiques permettent de composer des expressions de condition complexes a partir de 
variables booleennes ou d'autres expressions de condition. Ici aussi, vous pouvez utiliser les paren- 
theses pour forcer les priorites entre les operateurs ou simplement pour ameliorer la lisibilite du code 
en encadrant les expressions de condition. 



Tableau 7-22. Operateurs logiques 


Symbole 


Exemple 


Fonction Definition 


&& 


maVarl && maVar2 


ET Renvoie true (vrai) si les deux variables maVarl ET maVar2 sont 
true. 
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Tableau 7-22. Operateurs logiques (suite) 



Symbole 


Exemple 


Fonction 


Definition 


II 


maVarl | | maVar2 


ou 


Renvoie true (vrai) si au moins Tune des deux variables maVarl ou 








maVar2 est true. 


i 


ImaVarl 


Negation 


Renvoie la negation de maVarl. 



L'operateur logique permet de relier logiquement deux expressions booleennes. 



A noter 




Pour inserer le symbole logique OU ( 


), utilisez la combinaison de touches Alt Gr + 6. 



Voici deux exemples : 

If((maVarl>2) && (maVarl<5)) 
{ 

traceCla variable maVarl est plus grande que 2 mais inferieure a 5"); 
} 

n 

if((maVarl=="Jean") || (maVarl=="Fred" ) || (maVarl=="Marie")) 
{ 

traceCla variable maVarl est Jean, Fred ou Marie"); 

} 

Operateurs de concatenation 

L'operateur de concatenation est souvent utilise pour former des expressions a partir d'elements de 
differents types (variable avec du texte, par exemple) ou a partir d'autres expressions. L'operateur 
utilise pour relier ces expressions est le signe plus (+). 

A noter 

Comme l'operateur + est aussi utilise pour les operations arithmetiques, la concatenation ne sera effectuee que si 
I'un des elements a concatener est une chaine de caracteres (voir les exemples ci-dessous). 



Tableau 7-23. Operateur de concatenation 

Syntaxe 

Forme normale : [expression 3] = [expression l]+[expression 2] ; 

Legende : [xxx] : le code xxx est facultatif 

Attention ! vous ne devez surtout pas saisir les crochets [ et ] dans le code. 

Exemple : 

maVar2=maVarl+"euros" ; // Si maVarl est egale a 50, alors maVar2 est egale a "50 euros" 

L'operateur de concatenation permet de regrouper deux ou plusieurs expressions (si au moins l'une 
d'entre elles est une chaine de caracteres) et d'affecter ce resultat a l'expression de gauche. Comme 
pour les operateurs arithmetiques, il existe une forme compacte pour affecter une concatenation (voir 
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le second exemple ci-dessous). Cette forme est frequemment utilisee pour cumuler differentes 
expressions dans une meme variable : 

maVarl="Jean" ; 
maVar2="Fred" ; 

maVar3=maVarl+" et "+maVar2; 

trace( "maVar3="+maVar3) ; // Affiche maVar3=Jean et Fred 
// 

maVar3="Bonjour" ; 
maVar3+=maVarl ; 
maVar3 +=" et " ; 
maVar3+=maVar2; 

trace( n maVar3="+maVar3) ; // Affiche maVar3=Bonjour Jean et Fred 



Les fonctions integrees 

Les methodes des classes d'objets integres presentees precedemment sont des fonctions particulieres 
qui ne peuvent etre appliquees qu'a certaines classes. 



Rappel 

Pour relier ces methodes aux objets de la classe correspondante, il faut utiliser la syntaxe pointee (exemple : 
objetDate.getMonth( ) ou obj etAr ray .push ( "Al ain" )). 



Flash propose egalement des fonctions traditionnelles qui ne sont pas liees a des objets particuliers. 
Elles peuvent etre appelees directement (sans syntaxe pointee) depuis n'importe quel scenario 
(comme la fonction trace( ) que nous utilisons depuis le debut de ce chapitre pour afficher des infor- 
mations dans le panneau Sortie). Ces fonctions sont regroupees sous differentes rubriques dans le 
menu du panneau Actions. Nous vous en presentons quelques-unes ci-dessous, classees selon ces 
rubriques. Vous pouvez acceder a toutes les fonctions integrees de Flash en consultant le dictionnaire 
ActionScript ou en utilisant l'assistant d'edition du panneau Actions (cliquez sur le bouton + et selec- 
tionnez Fonctions globales dans les options du menu). 



Fonctions ActionScript d'impression 



Tableau 7.24. Fonctions ActionScript d'impression 



Syntaxe 


Description 


print (cible, "regionDimpression") 


Imprime le clip cible en fonction des limites specifiers dans le para- 
metre regionDimpression (bmovie, bmaxou bframe). 


print (niveau, "regionDimpression") 


Imprime le niveau en fonction des limites specifiees dans le parametre 
regionDimpression (bmovie, bmax ou bframe). 


printAsBi tmap (cible, "regionDimpression") 


Imprime le clip cible en tant que bitmap en fonction des limites specifiees 
dans le parametre regionDimpression (bmovie, bmax ou bframe). 


printAsBitmapNum (cible, 
"regionDimpression" ) 


Imprime le niveau en tant que bitmap en fonction des limites specifiees 
dans le parametre regionDimpression (bmovie, bmax ou bframe). 
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Fonctions ActionScript diverses 



Tableau 7-25. Fonctions ActionScript diverses 



Syntaxe 


Description 


getTimert ) 


Renvoie le nombre de millisecondes ecoulees depuis le demarrage de la lecture du fichier 
SWF. 


getVersion( ) 


Renvoie une chaine contenant la version de Flash Player et les informations de plate- 
forme. 


escape(expression) 


Convertit le parametre expression en une chaine et I'encode dans un format d'URL oil 
tous les caracteres non alphanumeriques sont echappes avec des sequences hexade- 
cimales. 


unescape(x) 


Evalue le parametre x comme une chaine, decode la chaine d'un format de code URL 
(convertit toutes les sequences hexadecimales en caracteres ASCII) et renvoie la chaine. 


setlnterval (NomDeFonction, 
interval le [, pa rami, ...]) 


Appelle unefonction, une methode ou un objet a intervalles periodiques pendant la lecture 
d'un fichier SWF. Vous pouvez utiliser unefonction d'intervalle pour mettre a jour des varia- 
bles d'une base de donnees ou mettre a jour un temps affiche. 
Description des parametres de la fonction : 

NomDeFonction : un nom de fonction ou une reference a une fonction anonyme. 
Intervalle : le temps qui s'ecoule entre les appels du parametre en millisecondes. 
paraml , . . . : parametres facultatifs transmis a la fonction ou au parametre NomDeMethode. 


cl earlnterval 
(IDsetlnterval ) 


Annule un appel a setlnterval ( ). Le parametre Isetlnterval permet de preciser 
I'appel setlnterval qui doit etre arrete. 


trace(expression) 


Evalue I'expression passee en argument et affiche les resultats dans le panneau Sortie en 
mode test. Cette action est souvent utilisee pour afficher des messages dans le panneau 



Sortie pendant le test d'une animation. Utilisez le parametre expression pour verifier si une 
condition existe ou pour afficher les valeurs dans le panneau Sortie. 



Fonctions ActionScript mathematiques 



Tableau 7-26. Fonctions ActionScript mathematiques 



Syntaxe 


Description 


is Finite (express ion) 


Evalue expression et renvoie true s'il s'agit d'un nombre fini et f al se s'il s'agit d'infini ou d'infini 
negatif. La presence d'infini, ou d'infini negatif, indique une condition d'erreur mathematique (une 
division par 0, par exemple). 


isNaN(expression) 


Evalue expression et renvoie true si lavaleur n'est pas un nombre (NaN), ce qui indique la pre- 
sence d'erreurs mathematiques. 


parselnt(chaine) 


Convertit chai ne en entier.Si la chaine specifiee ne peut pas etre convertie en un nombre, la fonc- 
tion renvoie NaN. Les chalnes commencant par Ox sont interpreters comme des nombres hexa- 
decimaux. Les entiers commencant par 0 ou specifiant une base de 8 sont interpret.es comme des 
nombres octaux. Les espaces precedant les entiers valides sont ignores, tout comme les carac- 
teres non numeriques a droite. 


parseFloat(chaine) 


Convertit chaine en nombre a virgule flottante. La fonction analyse et renvoie les nombres d'une 
chaine jusqu'a ce qu'elle atteigne un caractere qui n'appartient pas au nombre initial. Si la chaine 
ne commence pas par un nombre qui peut etre analyse, parseFl oat renvoie NaN. Les espaces 
precedant les entiers valides sont ignores, tout comme les caracteres non numeriques a droite. 
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Fonctions ActionScript de conversion 



Tableau 7-27. Fonctions ActionScript de conversion 



Syntaxe 


Description 


Arrayt [elementO [, elementl. 


.. ] ] ) Convertit les elements specifies en un tableau. 


Boolean(expression) 


Convertit expression en valeur booleenne ou renvoie une valeur selon le 
type de donnee de I'expression. 


Number(expression) 


Convertit expression en valeur numerique ou renvoie une valeur selon le 
type de donnee de I'expression. 


Objet(expression) 


Convertit expression en objetou renvoie une valeur selon le type de donnee 
de I'expression. 



St ring (express ion) Convertit expression en chalneou renvoie une valeur selon le type de donnee 

de I'expression. 



Gestion des evenements 

Nous vous avons presente les principaux elements utilises dans le code ActionScript et vous pouvez 
desormais ecrire des instructions et realiser de petits scripts. 

Cependant, dans Flash, chaque script doit etre declenche par un evenement (clic de la souris, appui 
sur une touche de clavier, apparition d'un clip sur la scene, deplacement de la tete de lecture sur une 
image specifique...). Pour controler ces differents evenements afin qu'ils n'executent un script, vous 
devrez placer le script sur une image precise d'un scenario (dans le cas des evenements d'images) ou 
dans le bloc code d'un gestionnaire d'evenements (dans le cas des evenements de souris et de clips). 
Nous allons nous pencher sur les differentes solutions de gestion d'evenements. 

Evenements d'images 

La lecture d'une animation Flash est similaire au fonctionnement d'un magnetoscope dans lequel une 
tete de lecture parcourt une bande magnetique afin d'en lire le contenu puis l'affiche a l'ecran. Dans 
le cas de Flash, la tete de lecture se deplace sur le scenario d'une animation (scenario principal ou 
celui d'un clip) et interprete son contenu d'une image a l'autre. Si l'image contient une simple 
animation de clip, celle-ci est transcrite par un mouvement du clip sur la scene ; de meme, si l'image 
cle comporte un script, toutes ses instructions seront executees. 

Les evenements d'images sont souvent employes pour declencher des actions a un moment donne du 
deroulement de l'animation et pour synchroniser son declenchement avec l'apparition d'un element 
sur la scene. 



A noter 

Dans la plupart des animations dynamiques, il est necessaire d'initialiser de nombreuses variables des le debut de 
l'animation (initialisation de variables, declaration de fonctions...). La tete de lecture se plagant toujours sur la 
premiere image d'une animation, il est judicieux de placer les instructions d'initialisation dans l'image 1 du scenario 
principal afin qu'elles soient executees des le lancement du projet. 
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En pratique, pour ajouter un script a une image cle d'un scenario, il faut d'abord selectionner celle-ci 
dans le scenario puis ouvrir le panneau Actions afin d'y saisir le script qui sera declenche lors du 
passage de la tete de lecture sur cette image. 

A noter 

Des qu'un script est saisi dans le panneau Actions pour une image cle, un petit « a » est ajoute a I'icone de I'image 
dans le scenario. 



Evenements de souris : on() 

Nous avons vu precedemment que les scripts d'evenements d'images etaient associes a une image cle 
specifique. Dans le cas des evenements de souris, le gestionnaire d'evenements doit etre associe a 
une occurrence de bouton ou de clip specifique (pour les clips, voir la remarque ci-apres). 



A noter 

En pratique, pour mettre en place un gestionnaire d'evenements, il faut d'abord selectionner le bouton concerne 
sur la scene, puis ouvrir le panneau Actions afin d'y ajouter le gestionnaire d'evenements puis le script en rapport. 
Dans le panneau Actions, il est interessant d'utiliser le raccourci clavier Esc + on afin d'afficher la structure du 
gestionnaire de souris. Le pointeur se positionne automatiquement entre les parentheses du gestionnaire et une 
fenetre vous invite a selectionner I'evenement a gerer. Selectionnez dans cette liste I'evenement desire et validez 
votre choix. II ne vous reste plus qu'a saisir le script entre les accolades (pour placer rapidement le pointeur entre 
les accolades, appuyez sur les touches Fin puis Entree). 



Gestionnaire de souris associe a un clip 

Depuis Flash MX, les evenements de souris peuvent etre associes aux occurrences de clips. Voici 
quelques conseils d'utilisation : 

• Dans la plupart des cas, il ne faut pas associer a la meme occurrence un evenement de souris et un 
evenement de clip (en cas d'absolue necessite, utilisez les methodes de gestionnaire d'evenements 
presentees dans ce chapitre). 

• Lorsqu'on attribue a une occurrence de clip un gestionnaire de souris, le curseur prend la forme 
d'une main comme s'il s'agissait d'un bouton. II conserve cependant toutes ses fonctionnalites de 
clip. 

• S'il est possible d'attribuer un gestionnaire de souris a une occurrence de clip, F attribution d'un 
gestionnaire de clip a une occurrence de bouton reste impossible. 

On peut maintenant attribuer des noms d'occurrence a un bouton et utiliser les proprietes et methodes 
de clip habituelles pour un bouton (exemple : bouton_btn._rotation pour appliquer une rotation au 
symbole du bouton). Cependant, les boutons ne deviennent pas pour autant des scenarios indepen- 
dants (comme les clips) et restent des elements de scenario. II convient done d'utiliser les chemins en 
rapport avec le scenario qui contient les boutons a cibler. 
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Bouton de souris maintenu : on(press) 

Ce gestionnaire detecte si le bouton de la souris est enfonce alors que le pointeur se trouve au-dessus 
de l'occurrence du bouton (ou du clip). 

II permet d'emuler la saisie d'un objet sur la scene, par exemple. 



Tableau 7-28. Gestionnaire de die souris 



Syntaxe 


on(press) { 




// Actions executees si l'evenement est detecte 
} 




Exemple (ce script doit etre place sur l'occurrence d'un bouton ou d'un clip) : 




on (press) { 




traceCclic bouton souris detecte"); 





) 



Bouton de souris relache : on(release) 

Ce gestionnaire detecte si le bouton de la souris est relache alors que le pointeur se trouve au-dessus 
de l'occurrence d'un bouton (ou d'un clip). 

II est frequemment utilise pour detecter la selection d'un objet sur la scene (la zone sensible de F objet 
peut etre delimitee par un bouton transparent, par exemple). 

Tableau 7-29. Gestionnaire de bouton de souris relache 



Syntaxe 




on(release) ( 

// Actions executees si l'evenement est detecte 
} 

Exemple (ce script doit etre place sur l'occurrence d'un bouton ou d'un clip) : 
on (release) ( 

tracet "bouton souris relache detecte"); 

} 



Bouton de souris relache en dehors de la zone sensible : on(releaseOutSide) 

Ce gestionnaire detecte si le bouton de la souris est relache alors que le pointeur se trouve en dehors 
de l'occurrence du bouton ou du clip (apres un clic prealable sur le bouton de la souris pendant que 
le pointeur etait a l'interieur de l'occurrence du bouton ou du clip). 

II peut etre utilise pour creer un jeu dans lequel l'utilisateur doit glisser-deposer un element parti- 
culier. 
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Tableau 7-30. Gestionnaire de bouton de souris relache en dehors de la zone sensible 



Syntaxe 


on(releaseOutSide) { 






// Actions executees si 1'evenement est detecte 

} 






Exemple (ce script doit etre place sur 1 'occurrence 


d'un bouton ou d'un clip) : 




on (releaseOutSide) ( 






traceCun relachement du bouton de la souris en 

} 


dehors de l'occurrence est detecte"); 





Touche clavier enfoncee : on(keyPress) 

Ce gestionnaire detecte si la touche specifiee dans F argument est enfoncee. Pour preciser quelle 
touche declenchera le script, il faut ajouter son code (exemple : 65 pour la touche A) ou son nom 
(exemple : <Space> pour la touche Espace) en argument apres le mot-cle keyPress. Pour connaitre les 
codes ou les noms des differentes touches du clavier, consultez le guide de reference ActionScript de 
l'aide a la rubrique Touches du clavier et valeur de code. 

Ce gestionnaire peut etre utilise pour demarrer une animation des que Futilisateur appuie sur une 
touche determinee ou pour controler le deplacement d'un clip a Faide du clavier. 



Tableau 7-31. Gestionnaire de touche de clavier enfoncee 



Syntaxe 


ontkeyPress "touche") { 




// Actions executees si 1'evenement est detecte 

12 




Exemple (ce script doit etre place sur l'occurrence d'un bouton ou d'un clip) : 




on (keyPress "<Space>") { 




traced 'appui sur la touche Espace est detecte"); 

} 





Survol du pointeur de la souris : on(rollOver) 

Ce gestionnaire detecte si le pointeur de la souris passe au-dessus de l'occurrence d'un bouton ou 
d'un clip. 

II peut etre utilise pour afficher des informations complementaires lors du survol d'un bouton avant 
que Futilisateur clique dessus. 



Tableau 7-32. Gestionnaire de survol du pointeur de la souris 



Syntaxe 


on(rollOver) ( 




// Actions executees si 1'evenement est detecte 

} 




Exemple (ce script doit etre place sur l'occurrence d'un bouton ou d'un clip) : 




on (rollOver) { 




traceCle bouton est actuel 1 ement survole par la souris"); 

12 
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Eloignement de la zone sensible : on(rollOut) 

Ce gestionnaire detecte si le pointeur de la souris s'eloigne de l'occurrence d'un bouton ou d'un clip. 

II peut etre utilise pour afficher un message lorsque l'utilisateur s'eloigne de la zone active d'un 
bouton ou d'un clip. 

Tableau 7-33. Gestionnaire d'eloignement de la zone sensible 

Syntaxe 

on(rollOut) ( 

// Actions executees si l'evenement est detecte 

[} 

Exemple (ce script doit etre place sur l'occurrence d'un bouton ou d'un clip) : 
on (rollout) ( 

traceCle pointeur de la souris est maintenant en dehors de la zone active du bouton"); 

} 

Deplacement sur la zone sensible : on(dragOver) 

Ce gestionnaire detecte si, apres avoir clique sur l'occurrence d'un bouton ou d'un clip, le pointeur 
sort de la zone sensible puis revient au-dessus. 

II peut emuler Taction de frotter un objet sur la scene. 

Tableau 7-34. Gestionnaire de deplacement sur la zone sensible 

Syntaxe 

on(dragOver) { 

// Actions executees si l'evenement est detecte 

| } 

Exemple (ce script doit etre place sur l'occurrence d'un bouton ou d'un clip) : 
on (dragOver) { 

traceCle pointeur de la souris frotte la zone active du bouton"); 

} 

Clic et sortie de la zone sensible : on(dragOut) 

Ce gestionnaire detecte si, apres avoir clique sur l'occurrence d'un bouton ou d'un clip, le pointeur 
sort de la zone sensible sans y revenir. 

II peut emuler le comportement d'un utilisateur qui clique sur un objet et s'eloigne aussitot. 
Tableau 7-35. Gestionnaire de clic et sortie de la zone sensible 

Syntaxe 

on(dragOver) { 

// Actions executees si l'evenement est detecte 

LL. 
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Tableau 7-35. Gestionnaire de die et sortie de la zone sensible (suite) 

Exemple (ce script doit etre place sur I'occurrence d'un bouton ou d'un clip) : 
on (dragOut) ( 

traceCle pointeur de la souris est sorti de la zone apres l'avoir sel ectionnee" ) ; 

} 



Evenements de clips : onClipEventQ 

Contrairement aux gestionnaires d'evenements de souris, qui peuvent etre integres a une occuiTence 
de bouton ou de clip, les gestionnaires d'evenements de clips ne peuvent etre integres qu'a une occur- 
rence de clip. 

lis permettent de declencher des scripts lorsqu'un clip est ajoute ou supprime de la scene, mais aussi 
de tester le chargement complet de donnees issues d'un fichier exterieur ou de detecter le mouvement 
de la souris ou Faction sur une combinaison de touches du clavier. 

Instanciation d'un clip : onClipEvent(load) 

Ce gestionnaire detecte si un clip specifique (celui dans lequel est integre le gestionnaire) est instancie 
(creation d'une occurrence de clip) et apparait sur la scene. 

II peut etre utilise pour declencher un script d'initialisation du clip concerne lors de son apparition sur 
la scene. 



Tableau 7-36. Gestionnaire d'instanciation d'un clip 



Syntaxe 


onClipEvent(load) { 




// Actions executees si 1'evenement est detecte 

[} 




Exemple (ce script doit etre place exclusivement sur I'occurrence d'un clip) : 




onClipEvent (load) { 




traceCle clip "+this+" vient d'apparaitre sur la scene"); 




} 

//Si, par exemple, le gestionnaire ci-dessus a ete ajoute a I'occurrence 


de clip monClipljic sur le 


scenario principal (_root ou encore _levelO), des le chargement du clip, le 


message suivant est affiche 


dans le panneau Sortie : 




le clip _1 evel O.monCl ipl_mc vient d'apparaitre sur la scene 





Suppression d'un clip : onClipEvent(unLoad) 

Ce gestionnaire detecte si une occurrence du clip dans lequel il est integre quitte la scene. 
II peut etre utilise pour afficher un message lorsqu'un clip est supprime de la scene. 

Tableau 7-37. Gestionnaire de suppression d'un clip 



Syntaxe 

onCl ipEvent(unLoad) { 

// Actions executees si 1'evenement est detecte 

} 
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Tableau 7-37. Gestionnaire de suppression d'un clip (suite) 

Exemple (ce script doit etre place exclusivement sur I'occurrence d'un clip) : 
onClipEvent (unLoad) { 

traceC'le clip "+this+" vient de disparaltre de la scene"); 

} 

//Si, par exemple, le gestionnaire ci-dessus a ete ajoute a I'occurrence de clip monClipl_mc sur le 
scenario principal (_root ou encore _levelO), des la suppression du clip, le message suivant est 
affiche dans le panneau Sortie : 

le clip _1 evel O.monCl ipl_mc vient d'etre supprime de la scene 



Moteur de script : onClipEvent(enterFrame) 

Ce gestionnaire est declenche continuellement a la cadence du clip, d'ou son nom. Par exemple, si la 
cadence d'affichage des images est de douze images par seconde (12 ips), le script du gestionnaire 
sera execute douze fois par seconde. 

A noter 

Le script associe a I'evenement est traite avant les actions associees aux images. 



En pratique, ce gestionnaire est souvent utilise (il est d'ailleurs recommande par Macromedia depuis 
Flash MX). Par exemple, il peut etre utilise pour surveiller F apparition d'un etat specifique (comme 
la collision de deux clips) ann de generer un programme en rapport ou encore pour faire evoluer un 
compteur des que le clip est actif (voir exemple ci-dessous). 

Tableau 7-38. Gestionnaire de moteur de script 




onCl ipEvent(enterFrame) { 

// Actions executees en continu 

} 

Exemple (ce script doit etre place exclusivement sur I'occurrence d'un clip) : 
onClipEvent (enterFrame) { 
_root.x++; 

traceC'la nouvelle valeur du compteur est "+_root.x); 

} 

// Dans cet exemple, la variable du compteur a ete initialisee a 0 sur l'image 1 du scenario principal 
(var x:number=0; ) . 

// Le gestionnaire ci-dessus a ete ajoute sur I'occurrence de clip monClipl_mc qui est place sur le 
scenario principal . 

// Des que le clip monClipl_mc est charge, les valeurs successives du compteur sont affichees dans 
le panneau Sortie (1 puis 2, 3...). 



Detection de mouvement de souris : onClipEvent(mouseMove) 

Ce gestionnaire detecte chaque deplacement de la souris. Pour connaitre la position de celle-ci, vous 
pouvez utiliser les proprietes _xmouse et _ymouse comme dans Fexemple ci-dessous. 
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Tableau 7-39. Gestionnaire de detection de mouvement de souris 



Syntaxe 




onCl ipEvent(unLoad) 

// Actions executees si 1'evenement est detecte 

} 

Exemple (ce script doit etre place exclusivement sur I'occurrence d'un clip) : 
onCl ipEvent(mouseMove) { 

souri sX=_root ._xmouse ; 

sourisY=_root._ymouse; 

traceC'le curseur de la souris se trouve en X="+sourisX+"et en Y="+souri sY" ) ; 

} 

// Si, par exemple, le gestionnaire ci-dessus a ete ajoute a I'occurrence de clip monClipl_mc sur le 
scenario principal (_root ou encore _levelO), des que la souris se deplace, le message suivant est 
affiche dans le panneau Sortie : 

le curseur de la souris se trouve en X=596 et en Y=268 



Bouton de souris enfonce : onClipEvent(mouseDown) 

Ce gestionnaire detecte que le bouton de la souris est enfonce quelle que soit la position du curseur 
sur la scene. 



A noter 

Contrairement aux gestionnaires on (press) et on (release), pour lesquels le script est declenche uniquementsi 
le bouton de la souris est enfonce ou relache sur I'occurrence du clip, les gestionnaires onClipE- 
vent(mouseDown) et onCl ipEvent(mouseUp) reagissent aux memes actions quelle que soit la position du 
curseur sur la scene. 



Ce gestionnaire peut etre utilise pour afficher un message lorsque le bouton de la souris est presse a 
un endroit quelconque de la scene. 



Tableau 7-40. Gestionnaire de bouton de souris presse 



Syntaxe 



onCl ipEvent(mouseDown) ( 

// Actions executees si 1'evenement est detecte 

} 

Exemple (ce script doit etre place exclusivement sur I'occurrence d'un clip) : 
onCl ipEvent(mouseDown) ( 

trace( "bouton souris presse"); 

} 

// Si, par exemple, le gestionnaire ci-dessus a ete ajoute a I'occurrence de clip monClipl_mc sur le 
scenario principal, des que le bouton de la souris est presse, quelle que soit sa position sur la 
scene, le message suivant est affiche dans le panneau Sortie : 
bouton souris presse 
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Bouton de souris relache : onClipEvent(mouseUp) 

Ce gestionnaire detecte que le bouton de la souris est relache quelle que soit la position du curseur sur 
la scene. 

II peut etre utilise pour afficher un message lorsque le bouton de la souris est relache a un endroit 
quelconque de la scene. 

Tableau 7-41. Gestionnaire de bouton de souris relache 

Syntaxe 

onClipEvent(mouseUp) ( 

// Actions executees si l'evenement est detecte 

[} 

Exemple (ce script doit etre place exclusivement sur I'occurrence d'un clip) : 
onClipEvent(mouseUp) ( 

trace( "bouton souris relache"); 

) 

// Si, par exemple, le gestionnaire ci-dessus a ete ajoute a I'occurrence de clip monClipl_mc sur le 
scenario principal, des que le bouton de la souris est relache, quelle que soit sa position sur la scene, 
le message suivant est affiche dans le panneau Sortie : 
bouton souris relache 



Touche pressee onClipEvent(keyDown) 

Ce gestionnaire detecte si une touche du clavier est pressee. 

A noter 

Malgre leur ressemblance avec l'evenement de souris on (key Press), ce gestionnaire et le gestionnaire onCl ip- 
Even( key Up) sont plus puissants car ils permettent notamment de detecter des combinaisons de touches (pour 
mettre en place des raccourcis clavier par exemple) ou encore de detecter si une touche est relachee. 



Ce gestionnaire peut etre utilise pour detecter si une touche particuliere est activee et executer une 
action en consequence. L'evenement d'animation keyDown est generalement utilise en conjonction 
avec une ou plusieurs methodes et proprietes associees a Fobjet Key. Le script ci-dessous utilise 
Key . getCode ( ) pour determiner la touche enfoncee par l'utilisateur : si la touche enfoncee correspond 
a la propriete Key. RIGHT, 1'animation est envoyee vers l'image suivante ; si la touche enfoncee 
correspond a la propriete Key . LEFT, 1'animation est envoyee vers l'image precedente. 

Tableau 7-42. Gestionnaire de touche de clavier pressee 

Syntaxe 

onClipEvent(keyDown) { 

// Actions executees si l'evenement est detecte 
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Tableau 7-42. Gestionnaire de touche de clavier pressee (suite) 

Exemple (ce script doit etre place exclusivement sur I'occurrence d'un clip) : 
onClipEventtkeyDown) { 

if (Key.getCodeO == Key. RIGHT) { 

_parent.nextFrame( ) ; 
} else if (Key.getCodeO == Key. LEFT) ( 
_pa rent. pre vFrame( ) ; 

) 

} 

// Si, par exemple, le gestionnaire ci-dessus a ete ajoute a I'occurrence de clip monClipl_mc sur les 
trois images cles du scenario principal, vous pourrez naviguer d'une image a l'autre en utilisant les 
touches Droite et Gauche du clavier. 

Touche de clavier relachee : onClipEvent(keyUp) 

Ce gestionnaire detecte si une touche du clavier est relachee. 

II peut etre utilise pour afficher un message si la touche Fi n du clavier est relachee. 

Tableau 7-43. Gestionnaire de touche de clavier relachee 

Syntaxe 

onCl ipEventt keyUp) { 

// Actions executees si 1'evenement est detecte 

| } 

Exemple (ce script doit etre place exclusivement sur I'occurrence d'un clip) : 
onCl ipEventt keyUp) { 

if (Key.getCodeO == Key. END) { 
traceOla touche Fin est relachee"); 

) 

} 

//Si, par exemple, le gestionnaire ci-dessus a ete ajoute a I'occurrence du clip monClipl_mc, lorsque 
la touche Fin du clavier est relachee, le message suivant est affiche dans le panneau Sortie : 

la touche Fin est relachee 

I I 

Donnees chargees : onClipEvent(data) 

Ce gestionnaire detecte si une source de donnees externe est completement chargee. Les donnees 
externes peuvent etre chargees al'aide d'une action loadVari ablest ) ou loadMoviet ). La detection de 
1'evenement data lance le traitement des donnees uniquement si celles-ci sont disponibles, afin 
d'eviter d'appeler une donnee manquante et de provoquer des erreurs. 



A noter 

Lorsqu'il est specifie avec une action loadVari ablest ), 1'evenement data ne survient qu'une seule fois, quand 
la derniere variable est chargee. Lorsqu'il est specifie avec une action 1 oadMovi e, il se repete plusieurs fois, au fur 
et a mesure que les sections de donnees sont recuperees. 
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Tableau 7-44. Gestionnaire de donnees chargees 




Syntaxe 




onCl i pEvent(data) { 

// Actions executees si l'evenement est detecte 

[} 


Exemple (ce script doit etre place exclusivement sur I'occurrence d'un clip) : 
onClipEvent (load) { 

loadVariabl est "maDate.txt" .this); 




} 

onClipEvent (data) { 

traceC'la date du RDV est le "+monJour+"/"+monMois+"/"+monAnnee) ; 





} 

// On suppose qu'un fichier texte maDate.txt contenant les informations suivantes : monJour=23&mon- 
Mois=mai&monAnnee=2004 a ete preal abl ement enregistre dans le meme repertoire que 1 'animation Flash. 
// Des le chargement du clip sur lequel ont ete integres les deux gestionnai res ci-dessus, le message 
suivant est affiche dans le panneau Sortie : 
la date du RDV est le 23/mai/2004 



Methodes de gestionnaires d'evenements 

Les methodes de gestionnaires d'evenements permettent de detecter des evenements abstraits (son, 
XML, configuration de la scene, chargement dynamique de donnees, etc.) pour lesquels il n'est pas 
possible d'utiliser un gestionnaire d'evenements traditionnel (gestionnaires de souris ou de clip). 
Ces methodes peuvent egalement etre exploiters pour depasser les limites d' utilisation des gestion- 
naires traditionnels. Elles permettent notamment de modifier les evenements pour lesquels ils 
doivent reagir ainsi que les scripts qu'ils doivent executer, ou encore de definir dynamiquement un 
gestionnaire traditionnel. 

Tableau 7-45. Syntaxe d'une methode de gestionnaires d'evenements 

nomObjet.nomEvenement=function( ) { 

// Actions executees si l'evenement est detecte 

| } 

nomObjet : nom de I'objet auquel doit etre applique le gestionnaire d'evenements. II peut s'agir d'une occurrence de clip, de 
bouton, d'un champ texte, d'un objet son ou d'un objet XML. 

nomEvenement : nom de l'evenement qui declenchera Pexecution du script. II peut s'agir d'un evenement traditionnel comme 
onPress, onRelease, onRol 1 Over... (voir tableau 7-46) ou d'un evenement ne possedant pas d'equivalence trad itionnelle 
comme onSetFocus, onSoundCompl ete, onSelect (voir tableau 7-47). 

Pour declarer une methode de gestionnaires d'evenements, vous devez selectionner une image dans le scenario puis ouvrir le 
panneau Actions. Saisissez ensuite le nom de I'objet (utilisez les suffixes d'objet :_btn, _mc, _txt...) auquel doit s'appliquer le 
gestionnaire, puis le nom de l'evenement qui declenchera le script, separe par un point (voir les listes d'evenements dans les 
tableaux 7-46 et 7-47). 

A noter : des que le point est saisi, une fenetre d'assistance s'affiche et propose les differents evenements disponibles selon le 
type d'objet concerne. Selectionnez l'evenement desire dans la liste et validez a I'aide de latouche Entree. Ajoutez ensuite un 
signe egal (=) et le mot-cle function( ) puis une accolade ouvrante (utilisez le raccourci Esc + fn). Sur les lignes suivantes, 
saisissez les instructions du script et cloturez le bloc en ajoutant une accolade fermante sur la derniere ligne de la declaration. 
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Tableau 7-45. Syntaxe d'une methode de gestionnaires d'evenements (suite) 

Attention ! 

A la difference d'un gestionnaire d'evenements traditionnel, la declaration d'une methode de gestionnaires d'evenements doit 
etre integree dans une image cle et non sur I'occurrence concernee. 

L'occurrence de I'objet concerne doit etre presente sur la scene (ou deja creee dans le cas d'un objet abstrait) lors de la decla- 
ration de la methode. 

La declaration de la methode est supprimee des que l'occurrence quitte la scene. II faut done declarer de nouveau la methode 
si I'objet revient sur la scene. 

Comparatif de la declaration d'un evenement traditionnel avec la syntaxe standard et avec la syntaxe d'une methode de 
gestionnaires d'evenements : 

Syntaxe d'un gestionnaire standard (ce script doit etre place sur l'occurrence du bouton monBouton_btn) : 
on(press){ 

tracefVous avez clique sur le bouton"); 

} 

Syntaxe d'une methode de gestionnaire (ce script doit etre place sur une image cle et le bouton monBouton_btn doit etre pre- 
sent sur la scene) : 
monBouton_btn.onPress = function(){ 
tracefVous avez clique sur le bouton"); 

} 

Au lieu d'employer un bloc de script integre au gestionnaire, vous pouvez aussi faire reference a une fonction declaree au prea- 
mble et contenant le script. Dans ce cas, la syntaxe de declaration d'une methode de gestionnaire est la suivante : 
Syntaxe alternative d'une methode de gestionnaire (ce script doit etre place sur une image cle et le bouton monBouton_btn doit 
etre present sur la scene) : 
detectionBouton = function(){ 
tracefVous avez clique sur le bouton"); 

} 

monBouton_btn.onPress = detectionBouton ; 

Annulation d'une methode de gestionnaires d'evenements : 

Remarque : dans les exemples ci-dessous, on suppose que la methode de gestionnaires d'evenements suivante a ete preala- 
blement declaree (ce gestionnaire declenche la rotation permanente du clip) : 
monClipjnc.onEnterFrame = function() { 
this._rotation +=10 

} 

II existe deux syntaxes pour supprimer une methode : 
Syntaxe 1 : monCl ipjnc.onEnterFrame = null; 
Syntaxe 2 : del ete monCl ip_mc.onEnterFrame; 



Les methodes de gestionnaires d'evenements peuvent egalement detecter tous les evenements tradi- 
tionnels. II faut dans ce cas utiliser des noms d'evenements equivalents a ceux utilises avec la syntaxe 
standard. On les construit en prefixant le nom de 1' evenement standard par on et en remplacant la 
premiere lettre de 1' evenement par une majuscule. Par exemple, pour construire 1' equivalent d'un 
evenement press (dont la syntaxe traditionnelle est on(press )), il suffit d'ajouter le prefixe on, ce qui 
donne onPress. 
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Tous les gestionnaires d'evenements traditionnels ont leur equivalent. Le tableau 7-46 repertorie les 
plus courants. 

Tableau 7-46. Equivalences avec les gestionnaires d'evenements traditionnels 



Evenements traditionnels 


Equivalence : evenements avec methode 


on(press) 


nomCl ipOuBouton .on Press 


on(release) 


nomCl ipOuBouton .on Release 


on(releaseOutside) 


nomCl ipOuBouton .on Rel easeOutside 


on(keyPress) 


nomCl ipOuBouton .on Key Press 


ontrol 1 Over) 


nomCl ipOuBouton .on Rol lOver 


on(rollOut) 


nomCl ipOuBouton .on Rol 1 Out 


on(dragOver) 


nomCl ipOuBouton .onDragOver 


on(dragOut) 


nomCl ipOuBouton .onDragOut 


onClipEven(load) 


nomCl ip.onLoad 


onCl ipEven(unLoad) 


nomCl ip.onUnLoad 


onClipEven( enter Frame) 


nomCl i p. on Enter Frame 


onCl ipEven(mouseMove) 


nomCl ip.onMouseMove 


onCl ipEven(mouseDown) 


nomCl ip.onMouseDown 


onCl i pEven(mouseUp) 


nomCl ip.onMouseUp 


onCl i pEven( key Down ) 


nomCl ip.onKeyDown 


onClipEven(keyUp) 


nomCl ip.onKeyUp 


onCl ipEven(data) 


nomCl ip.onData 


Certains evenements utilisables avec une methode de gestionnaires d'evenements (comme les objets 
abstraits son, XML...) ne possedent pas d'equivalences standards. Voici la liste de ces evenements 
specifiques. 


Tableau 7-47. Methodes de gestionnaires d'evenements 




Evenements specifiques 


Bouton ou clip 


nomCl ipOuBouton .on Ki 1 1 Focus 


Bouton ou clip 


nomCl ipOuBouton .onSet Focus 


Son 


nomSon.onLoad 


Son 


nomSon . onSoundCompl ete 


Son 


nomSon.onID3 


Champ de texte 


nomChampDeTexte.onC hanged 


Champ de texte 


nomChampDeTexte.onKi 1 1 Focus 
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Tableau 7-47. Methodes de gestionnaires d'evenements (suite) 



Objets concernes 


Evenements specifiques 




Champ de texte 


nomChampDeTexte.onScrol ler 




Champ de texte 


nomChampDeTexte.onSet Focus 




Stage 


stage. onLoad 




Styl eSheet 


nomFeui 1 leStyl e. on Resize 




contextMenu 


nomMenu.onSelect 




contextMenuItem 


nomEl ementMenu . onSel ect 




1 oadVars 


nomObjetLoadVars .on Load 




ShareObjets 


nomObjetPartage.onStatus 




localConnection 


nomConnexi on Local e . al 1 owDomai n 




localConnection 


nomConnexi on Local e.onStatus 




netConnection 


nomConnexi on Net.onSt at lis 




netStream 


nomFl uxNet.onStatus 




XML 


nomXML.onData 




XML 


nomXML.onLoad 




XMLSocket 


nomXMLSocket.onClose 




XMLSocket 


nomXMLSocket .onConnect 




XMLSocket 


nomXMLSocket.onData 




XMLSocket 


nomXMLSocket. onXML 






Voici plusieurs scripts qui utilisent les methodes des gestionnaires d'evenements : 

Exemple 1 : dans cet exemple, des qu'un caractere est insere dans le champ texte monChamp_txt, 
l'evenement est detecte par la methode monChamp_txt . onChanged qui execute un script faisant pivoter 
de 45° le clip voyant_mc (un champ texte nomme monchamp_txt et un clip voyant_mc doivent etre crees 
au prealable sur la scene). 

(Ce script doit etre place sur une image cle et les occurrences des elements doivent etre presentes sur 
la scene.) 

monChamp_txt. onChanged = function(){ 
voyant_mc._rotation += 45; 

I > 

Exemple 2 : c'est une evolution du premier exemple (les elements monChamp_txt et voyant_mc sont 
toujours sur la scene). La premiere methode declenche la rotation continue (evenement onEnter- 
Frame) du voyant des que le pointeur de la souris est place dans le champ texte (evenement onSetFocus). 
La deuxieme methode permet de detecter un changement dans le champ texte (evenement onChanged) 
et annule les deux actions precedemment activees (onSetFocus et onEnterFrame) puis pivote le voyant 
de 45° dans le sens inverse pour chaque caractere saisi. 
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(Ce script doit etre place sur l'image cle 1 et les occurrences des elements doivent etre presentes sur 
la scene.) 

monChamp_txt.onSetFocus = function(){ 
voyantjnc.onEnterFrame = function(){ 



Exemple 3 : les methodes de gestionnaires d'evenements donnent aussi la possibilite de changer 
Fevenement qui controle une action (ici modification de Falpha du bouton). Pour cela, nous avons 
cree deux images cles dans lesquelles se trouve un bouton nomme monBouton_btn. Dans la premiere 
image cle nous avons configure deux methodes qui controlent 1' alpha avec un clic souris et qui depla- 
cent la tete de lecture sur l'image 2 lorsque le bouton est relache. Dans l'image 2, les deux premieres 
lignes annulent les methodes precedentes. Les lignes suivantes decrivent deux methodes qui gerent 
Falpha du bouton, cette fois controle avec rol 1 Over et rol 1 Out. 

Script de l'image 1 : 
stop( ) ; 

monBouton_btn.onPress=function () { 
this._alpha=50; 

} 

monBouton_btn.onRelease=f unction () { 
this._alpha=100; 
gotoAndStop(2) ; 

} 

Script de 1 ' image 2 : 
stop( ) ; 

monBouton_btn.onPress=null ; 
monBouton_btn.onRelease=null ; 
monBouton_btn.onRollOver=f unction () { 
this._alpha=50; 

} 

monBouton_btn.onRol 10ut=function () { 
this._alpha=100; 

} 

Mieux programmer avec les methodes de gestionnaires d'evenements : 

Lorsque vous utilisez des methodes de gestionnaires d'evenements, leurs scripts, au lieu d'etre 
disperses sur les differents objets auxquels ils se rapportent, sont centralises dans le panneau Actions 
de l'image cle. En termes de programmation, c'est tres interessant car il n'est pas necessaire de se 
positionner sur les objets pour modifier un script. Nous vous conseillons done d'utiliser le plus 
souvent possible ces methodes dans vos futurs programmes. 




this._rotation += 45; 



monChamp_txt.onChanged = function(){ 
monChamp_mc.onSetFocus = null; 
voyantjnc.onEnterFrame = null; 
voyant_mc._rotation -= 45; 
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Les ecouteurs d'evenements 

Les gestionnaires precedents peuvent repondre aux attentes de la plupart de vos projets. Cependant, 
dans certains cas, vous aurez peut-etre besoin d'appliquer un gestionnaire d'evenements a un objet 
qui n'est pas prevu pour reagir a l'evenement en question. Dans ce cas, Futilisation d'un ecouteur 
d'evenements peut etre la solution. 

Les ecouteurs d'evenements permettent a un objet, appele objet d'ecoute, de recevoir des evenements 
generes par un autre objet, appele objet diffuseur. 

Prenons un exemple concret. Posons l'hypothese que vous desirez creer une application qui 
affiche le texte « CLIC » dans un champ texte des que Ton clique dessus. L'ideal serait d'utiliser 
l'evenement onMouseDown applique a un champ texte, mais cela n'est pas possible avec un gestion- 
naire d'evenements traditionnel (ni avec une methode d'evenements, d'ailleurs) car l'objet TextFi el d 
ne dispose pas d'evenements onMouseDown. Pour vous en convaincre, saisissez le nom de l'occurrence 
du champ texte suivi d'un point (soit monChamp_txt.) pour faire apparaitre la liste des proprietes, 
methodes et evenements disponibles pour cet objet. Aucun evenement onMouseDown n'apparait dans la 
liste. 

Dans ce cas, la solution consiste a utiliser un ecouteur d'evenements en declarant un objet diffuseur 
associe a un gestionnaire d'evenements approprie (l'objet d'ecoute). Creez un objet Champ de texte 
dynamique nomme monChamp_txt. Selectionnez ensuite l'image cle 1 du scenario principal et saisis- 
sez la methode de gestionnaires d'evenements monChamp_txt. onMouseDown qui fera office d'objet 
d'ecoute comme indique dans le script ci-dessous : 

monChamp_txt.onMouseDown=f unction () { 
monChamp_txt.text="CLIC" ; 

Cependant, comme nous l'avons indique precedemment, le gestionnaire d'evenements onMouseDown 
(l'objet d'ecoute) ne peut pas etre applique a un objet Champ de texte (classe TextFi el d). Pour que le 
gestionnaire reagisse a l'evenement onMouseDown, il faut ajouter un objet diffuseur en saisissant 



l'instruction suivante : 




Mouse. add Li stener(monChamp_txt) ; 




Tableau 7-48. Syntaxe des ecouteurs d'evenements 




Declaration d'un objet d'ecoute : 
nomObjetEcoute.nomEvenement=function( ) ( 

// Actions executees si l'evenement est detecte par le diffuseur et transmis a 

1) 


1 

'objet d'ecoute 


Enregistrement d'un objet d'ecoute par un objet diffuseur : 
nomObjetDif fuseur . add Li stener(nomObjetEcoute) ; 
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Tableau 7-48. Syntaxe des ecouteurs d'evenements (suite) 

nomObjetEcoute : nom de I'objet d'ecoute auquel doit etre applique le gestionnaire d'evenements. L'objet d'ecoute recevra les 
evenements de I'objet diffuseur des qu'il les aura detectes. Les objets d'ecoute peuvent etre des objets generiques (object) 
mais aussi des clips, des boutons, des champs texte, des tableaux (Array) ou tout type d'objet ActionScript. 
nomEvenement : nom de I'evenement qui declenchera I'execution du script. Attention ! A la difference d'un gestionnaire d'eve- 
nements standard, I'evenement ne fait pas partie des proprietes de I'objet d'ecoute mais doit etre reference par mi les methodes 
d'ecouteur de la classe de I'objet diffuseur. 

nomOb jet Diffuseur : nom de I'objet diffuseur qui transmettra I'evenement a I'objet d'ecoute. Ce nom est le nom d'une classe 
d'objets possedant des methodes d'ecouteur. Ces methodes sont disponibles pour les objets des classes suivantes : Key, 
Mouse, MovieCl i pLoader, Selection, TextFiel d et Stage. Pour obtenir la liste des methodes d'ecouteurs disponibles pour 
chaque classe, consultez les entrees de ces classes dans le dictionnaire d'ActionScript. 

Remarque : 

1 Les ecouteurs d'evenements utilisent la meme syntaxe que les methodes de gestionnaires d'evenements, a deux diffe- 
rences pres : 

- L'objet auquel vous affectez le gestionnaire d'evenements (I'objet d'ecoute) n'est pas I'objet qui emet I'evenement. 

- Outre la declaration du gestionnaire d'evenements, ilfaut appeler une methode speciale de l'objet diffuseur, addLi stenert ), 
qui enregistre l'objet d'ecoute (le nom de l'objet d'ecoute est passe en parametre) pour recevoir ses evenements. 

2 Plusieurs objets d'ecoute peuvent recevoir des evenements d'un seul objet diffuseur. Un seul objet d'ecoute peut recevoir des 
evenements de plusieurs objets diffuseurs. 

Exemple : 

// Declaration de l'objet d'ecoute 
monChamp_txt.onMouseDown=f unction () { 
monChamp_txt.text="CLIC ; 

} 

// Declaration de l'objet diffuseur 
Mouse. add Li stener(monChamp_txt) ; 
Annulation d'un ecouteur d'evenements : 

Pour annuler I'enregistrement d'un objet d'ecoute afin qu'il ne recoive plus d'evenements, il faut appeler la methode remove- 
Li stenert ) de l'objet diffuseur, en lui transmettant le nom de l'objet d'ecoute. 

Syntaxe 

nomOb jet Diffuseur. remove Li stenert nomObjetEcoute) ; 
Exemple : 

Mouse, remove Li stenert monChamp_txt) ; 



Tableau 7-49. Methodes d'ecouteur de la classe Key 



Methode 


Description 


Key.onKeyDownt ) 


Detecte qu'une touche du clavier est enfoncee. 


Key.onKeyUpt ) 


Detecte qu'une touche du clavier est relachee. 


Tableau 7-50. Methodes d'ecouteur de la classe Mouse 


Methode 


Description 


Key.onMouseDownt ) 


Detecte que le bouton de la souris est enfonce. 


Key.onMouseUpt ) 


Detecte que le bouton de la souris est relache. 


Key.onMouseMovet ) 


Detecte que la souris est deplacee. 


Key.onMouseWheel ( ) 


Detecte qu'une action sur la molette de la souris est declenchee. 
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Tableau 7-51 . Methodes d'ecouteur de la classe MovieClipLoader 



Methode 


Description 


Movi eCl i p Loader. on LoadCompl etetcibl e_mc) 


Detecte si un fichier charge a I'aide de MovieClipLoader. load- 
Cl i p( ) est entierement telecharge. 


MovieCl ip Loader . onLoadErrortcibl e_mc , 
codeErreur) 


Detecte si le chargement d'un fichier a I'aide de MovieCl ip- 
Loader .1 oadCl ip( ) aechoue. 


Movi eCl i p Loader .onLoadlni ttcibl e_mc) 


Detecte si les actions sur la premiere image du clip ont ete executees. 


MovieCl ip Loader . onLoadProgresstcibl e_mc 
[, loadedBytes [, total Bytes ] ]) 


Detecte chacune des fois ou le contenu de chargement est enregistre 
sur disque durant le processus de chargement. 


Movi eCl i p Loader .on LoadSt art (cibl e_mc) 


Detecte si un appel de MovieCl ipLoader. 1 oadCl ip( ) a initie letele- 
chargement d'un fichier. 


Tableau 7-52. Methodes d'ecouteur de la classe Selection 


Methode 


Description 


Select i on. onSet Focus ( ) 


Detecte lorsque le focus de saisie change. 


Tableau 7-53. Methodes d'ecouteur de la classe TextField 


Methode 


Description 


TextField. onChanged( ) 


Detecte lorsque le contenu du champ de texte change. 


TextField .onScrol 1 erf ) 


Detecte lorsque la propriete scroll ou maxscroll d'un champ 
de texte change. 


Tableau 7-54. Methodes d'ecouteur de la classe Stage 


Methode 


Description 


Stage. onResizet ) 


Detecte lorsque Stage. sea 1 eMode a pour valeur "noScal e" 
et que le fichier SWF est redimensionne. 



Exemple 1 : 

II montre comment utiliser Fecouteur d'evenements Selection.onSetFocus pour creer un gestion- 
naire de focus simple pour un groupe de champs de saisie de texte. La bordure du champ de texte qui 
recoit le focus clavier est activee et la bordure du champ de texte qui a perdu le focus est desactivee. 
L'objet d'ecoute utilise est un objet generique cree pour cet usage (ecouteurDeFocus). 

(Deux champs de texte de saisie doivent etre crees au prealable et porter les noms monChampl_txt et 
monChamp2_txt. L' option Affi cher la bordure autour du texte doit etre activee depuis le panneau de 
proprietes pour le premier champ.) 

var ecouteurDeFocus = new ObjectO; 

ecouteurDeFocus. onSetFocus = function(monChampl_txt, monChamp2_txt) { 
monChampl_txt. border = false; 
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monChamp2_txt. border = true; 
1 

Sel ecti on. add Listener (ecouteurDeFocus) ; 
Exemple 2 : 

Dans cet exemple, nous avons cree un ecouteur de clavier qui a pour fonction de detecter l'appui sur 
une touche. Des que la touche P est actionnee, un message s'affiche dans le panneau Sortie. L'objet 
d'ecoute utilise est un objet generique cree pour cet usage (ecouteurDeCl avier). 

var ecouteurDeCl avier = new ObjectO; // Creation d'objet generique 
ecouteurDeClavier.onKeyDown = functionO ( 
if(Key.isDown(80)){ 
trace ("la touche 'P' est enfoncee"); 

} 

} 

Key. add Listener (ecouteurDeCl avier) ; 



Incidences des evenements sur les clips 

Vous connaissez desormais les differents types de gestionnaires d' evenements que Ton peut utiliser 
dans Flash. Selon leur type et la maniere dont ils sont appliques a une occurrence de clip, ils peuvent 
avoir une incidence ponctuelle sur celle-ci ou etendue a toutes les autres occuiTences issues du clip 
maitre. 

Pour illustrer ce point important, nous allons utiliser une petite animation didactique dans laquelle 
deux occurrences de clip (issues d'un meme clip maitre representant une voiture) seront configurees 
a Faide de differents types de gestionnaires. 

Le but de cette application est de demontrer les points suivants : 

• Les evenements de souris appliques a un bouton de F occurrence d'un clip ou les evenements 
d'images integres dans le scenario de l'occurrence d'un clip changent les fonctionnalites et les 
proprietes du clip maitre, modifiant du meme coup par heritage toutes les occurrences de clip 
issues de ce celui-ci. 

• A l'inverse, les evenements de clip (ou les evenements de souris, sous certaines conditions) appli- 
ques a l'occurrence du clip ont uniquement une incidence sur les fonctionnalites et les proprietes 
de celle-ci et non sur le clip maitre. Ils permettent de personnaliser chaque occurrence de clip tout 
en conservant les proprietes du clip maitre. 

Avant de commencer la realisation de F animation, souvenez-vous que lorsque vous creez un symbole 
de type clip, le clip maitre ainsi cree herite des proprietes et des methodes de la classe d'objet Movi e- 
Cl i p et qu'il est automatiquement ajoute a la bibliotheque de Fanimation. Lorsque vous dupliquez ce 
clip maitre sur la scene par un simple glisser-deposer, une occurrence de ce clip est creee. Celle-ci 
herite des methodes et proprietes de la classe MovieCl ip, mais aussi des caracteristiques et des fonc- 
tionnalites du clip maitre. 

II est ensuite possible de personnaliser chaque occurrence en lui attribuant des caracteristiques ou 
fonctionnalites specifiques si Fon respecte certaines conditions. 
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Realisation d'une animation didactique 

1. Ouvrez un nouveau document Flash puis enregistrez-le sous le nom voiture.fla. Nommez 
l'unique caique du scenario principal route. 

2. Creez un symbole de type Clip nomme voiture_mc (par le menu : Insertion>Nouveau symbole 
ou a F aide du raccourci clavier Ctrl + F8). 

3. Dans le scenario du clip, creez quatre caiques nommes Actions, Numero, Boutons et Graphique. 

4. Dans le caique Graphique, dessinez schematiquement une voiture. 

5. Placez-vous dans le caique Numero et ajoutez un champ texte dynamique. Nommez son occur- 
rence numero_txt. Saisissez le chiffre 0 dans la valeur initiale du champ de texte et ajustez sa taille 
si besoin. 

6. Revenez sur l'image 1 du scenario principal et ajoutez deux occurrences du clip maitre voiturejnc 
sur la scene (positionnez la premiere occurrence en haut a gauche et nommez-la voiturel_mc; posi- 
tionnez la seconde en bas a gauche et nommez-la voiture2_mc), (voir figure 7-1) 
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Figure 7-1 

Creation des deux occurrences du clip maitre voiture_mc 



7. Ouvrez une des deux occurrences. Placez-vous dans le caique Boutons et ajoutez deux boutons : 
l'un a l'avant de la voiture, dont l'occurrence sera nommee avance_btn, et Fautre a l'arriere, dont 
l'occurrence sera nommee recul e„btn(voir figure 7-2) 
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8. Selectionnez le bouton avance_btn et ajoutez le gestionnaire d'evenements de souris suivant dans 
le panneau Actions : 

I on (press) { 
this.„x=this._x+5; 

I > 

9. Selectionnez le bouton recule_btn et ajoutez le gestionnaire d'evenements de souris suivant 
dans le panneau Actions. Cliquez ensuite sur l'icone Sequence 1 afin de revenir sur le scenario 
principal. 

I on (press) { 

I this._x=this._x-l; 




Figure 7-2 

Modification d'une occurrence du clip voiture_mc : ajout du bouton avance_btn et de son gestionnaire 
d'evenements de souris 



10. Revenez sur le scenario principal et testez une premiere fois votre animation (utilisez le 
raccourci clavier Ctrl + Entree). Les voitures doivent etre identiques et porter toutes deux le numero 
zero initialise par defaut. Assurez-vous que vous pouvez faire avancer et reculer les deux voitures 
en cliquant sur le bouton ad hoc (grace aux deux gestionnaires d'evenements de souris appliques 
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aux boutons du clip). Ce premier test permet de constater qu'un evenement de souris applique a 
un bouton situe dans une occurrence de clip se repercute sur le clip maitre et sur toutes les occur- 
rences de clip issues de ce dernier. 

1 1 . Revenez dans l'editeur et ouvrez le clip voi ture_mc. Dans le caique Actions, creez une image cle 
sur l'image 5 puis une seconde image cle sur l'image 10. Pour les trois autres caiques du scenario, 
creez une image cle directement dans l'image 10. 

12. Dans l'image cle 1 du caique Actions, saisissez le script ci-dessous, qui sera execute lors du 
passage de la tete de lecture sur les images 1 a 4 (evenement d'image). La premiere ligne permet 
d'affecter la valeur de la variable numero au champ texte numero_txt. La deuxieme ligne rend visible 
le champ texte numero_txt. 

numero_txt . text=numero ; 
I numero_txt._visible=true; 

13. Dans l'image cle 5, saisissez le script ci-dessous, qui sera execute lors du passage de la tete de 
lecture sur les images 5 a 10 (evenement d'image). Cette ligne de code rend invisible le champ 
texte numero_txt(voir figure 7-3) 

I numero_txt._visible=fal se; 




Figure 7-3 

Modification d'une occurrence du clip voiturejnc : ajout d'une image cle dans le caique Actions 
(evenement d'image) et du script correspondant 
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14. Revenez sur le scenario principal et testez une seconde fois l'animation. Les deux voitures ont 
encore des caracteristiques communes (meme taille et meme numero 0). Les fonctionnalites des 
deux occurrences etant heritees du clip maitre et done identiques, verifiez que les numeros des 
voitures clignotent (grace a Fevenement d'image). Ce deuxieme test permet de constater qu'un 
evenement d'image applique au scenario d'une occurrence de clip se repercute sur le clip maitre 
et done sur toutes les occurrences de clip issues de ce dernier. 

15. Fermez l'environnement de test et retournez dans Fenvironnement de developpement. Placez- 
vous sur la sequence et selectionnez la premiere occurrence, voiturel_mc, puis ajoutez le 
gestionnaire d'evenements de clip ci-dessous dans le panneau Actions afin de personnaliser 
F occurrence. La premiere ligne du bloc d' actions permet de personnaliser le numero de 1' occur- 
rence de cette voiture en declarant puis en affectant le chiffre 1 a la variable numero. Les deux 
autres lignes de code modifient la taille de F occurrence en appliquant un coefficient d'echelle de 
80 % (voir figure 7-4). 

onClipEvent (load) { 
var numero:String="l" ; 
this._xscale=80; 
this._yscale=80; 

} 




Figure 7-4 

Ajout d'un gestionnaire d'evenements de clip et du script correspondant sur V occurrence voitureljnc 
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16. Selectionnez ensuite la deuxieme occurrence, voiture2_mc, et ajoutez de la meme maniere le 
gestionnaire d'evenements de clip suivant. La premiere ligne du bloc de code declare et attribue 
le chiffre 2 a la variable numero. La deuxieme ligne modifie l'alpha du graphique de FoccuiTence 
en appliquant un coefficient de 50 % d'opacite. 

onClipEvent (load) { 
var numero:String="2" ; 
thi s ._al pha=50 ; 
} 

17. Testez de nouveau l'animation dans l'environnement de test (Ctrl + Entree). Cette fois, les 
deux voitures sont personnalisees : la premiere est legerement plus petite et porte le 
numero 1, alors que la seconde est plus transparente (alpha = 50 %) et porte le numero 2. 
Ces personnalisations sont liees aux gestionnaires d'evenements de clip appliques aux deux 
occurrences de clip (voir figure 7-5). Verifiez le fonctionnement des boutons et le clignotement 
des numeros afin de vous assurer que leurs fonctionnalites restent inchangees. Ce troisieme test 
permet de constater qu'un gestionnaire d'evenements de clip applique a une occurrence de clip 
n' a d' incidence que sur cette occurrence (il en serait de meme avec un gestionnaire d'evenements 
de souris). 



htdu r Ush ProftutoiMl 8 [voilurt.fW) 



□ % 

/ p 

u A 

O P. 

*> * 

s 0 



O Q, 



« • 

n 




(jeer. r«.w CeMHrdM Core* Fenetre *de 

n o oi n ••> •< o m 



L'occurence voiturel_mc est personnalisee 
* ' ^ avec le numero 1 et sa taille est reduite de 80% 




£ Docuntri 



FjcNw etftfege ControV tfefeoguer 




Les deux occurences voiturel_mc et voitue2_mc 
heritent des memes fonctionnalites et proprietes 
que le clip maitre, soient : Le numero clignotant 
et les 2 boutons de deplacement horizontal 




L'occurence voiture2_mc est personnalisee 
avec le numero 2 et avec un alpha de 50% 



Figure 7-5 

Test final de V application 
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18. Fermez l'environnement de test et retournez dans l'environnement de developpement pour enre- 
gistrer votre document. 
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Figure 7-6 

Si on observe I'explorateur d 'animation, on pent facilement identifier les gestionnaires d'evenements 
de clip appliques aux deux occurrences voiturel _mc et voiture2_mc ( repere 2) et les gestionnaires 
d'evenements de souris ainsi que les evenements d 'image appliques au clip maitre voiture_mc (repere 1). 



Synthese de I'animation didactique 

Cette animation nous a permis de demontrer F incidence des evenements selon leur type et la maniere 
dont ils sont appliques. Nous pouvons ainsi les classer en deux families distinctes : 

• les evenements qui modifient les caracteristiques et fonctionnalites du clip maitre et ont une reper- 
cussion sur toutes les occurrences issues de celui-ci ; 

• les evenements qui ne modifient que les caracteristiques et fonctionnalites d'une occurrence parti- 
culiere et qui permettent de personnaliser chaque occurrence tout en conservant l'heritage du clip 
maitre. 



Tableau 7-55. Classement des evenements selon leur incidence sur un clip 



Families 


Types d'evenements et methodes d'application 


Evenements modifiant le clip maitre 

(pour definir des caracteristiques et fonctionnalites 

communes a toutes les occurrences issues du clip 

maitre) 


Evenements d'image appliques a une image cle du scenario du clip 
maitre. 

Evenements de souris appliques aux boutons ou aux clips enfants 
integres au clip maitre 

Evenements de clip appliques aux clips enfants integres au clip maitre 


Evenements modifiant I'occurrence du clip 
(pour personnaliser chaque occurrence de clip en 
lui attribuant des caracteristiques et fonctionnalites 
specifiques) 


Evenements de clip appliques a une occurrence du clip maitre 
Evenements de souris appliques a une occurrence du clip maitre 
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Ciblage des elements 

Dans les projets Flash, vous aurez souvent besoin de referencer un element particulier afin de recupe- 
rer ou modifier la valeur d'une variable ou d'une propriete, ou encore d'appeler une fonction ou une 
methode d'objet. Chaque element d'un scenario doit pouvoir cibler un element situe dans un scenario 
different. Nous utiliserons par la suite le terme de « chemin cible » pour designer le nom de 1' element 
et ses eventuels prefixes qui permettent de referencer sans ambiguite un element Flash. Voici les 
differentes manieres de structurer ce chemin cible (nous parlerons par la suite de « ciblage »). 



Utilisez le bouton Chemin cible de I'editeur de script 

Le bouton Chemin cible place dans la barre de menu de I'editeur de script permet d'inserer rapidement et sans 
risque d'erreur de frappe le chemin correspondant a un element cible (voir figure 7-7). Le chemin peut etre insere 
en mode relatif (par rapport au scenario dans lequel sera ajoute le code) ou en mode absolu (par rapport au scena- 
rio principal _root). Pour que le chemin menant a un element puisse etre insere dans le code, il faut que son nom 
d'occurrence et celui de tous les elements inseres dans le chemin soient renseignes au prealable. Une fois le 
chemin insere dans la zone de script, il suffit de saisir un point ( .) pour obtenir la liste des proprietes ou methodes 
correspondant a I'objet cible. 
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Figure 7-7 

Le bouton Chemin cible de I'editeur de script permet d'inserer rapidement un chemin absolu ou relatif 
lors de la redaction d'un script. 



Chemin cible relatif ou absolu 

Pour ecrire un chemin cible, nous utiliserons la syntaxe pointee (chaque partie constituant le chemin 
est separee par un point). Un chemin cible peut etre absolu ou relatif. 

Un chemin cible absolu decrit en premier le conteneur le plus eleve (soit F animation principale 
caracterisee par le scenario principal : _root) puis nomme successivement les differents conteneurs 
enfants suivant Fordre d'heritage. Le dernier element du chemin est la propriete (comme dans 
l'exemple ci-dessous avec .text) ou la methode de I'objet cible. (voir figure 7-9) 
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Exemple de chemin cible absolu : 

_root.clipPerel_mc.cl ipEnf ant l_mc.monMessagel_txt. text 

Les chemins cibles absolus ont l'avantage de pouvoir etre utilises (sans etre modifies) depuis 
n'importe quel endroit de la hierarchie d'un projet Flash. 

Un chemin cible relatif contient le pointeur optionnel thi s suivi d'un ou plusieurs pointeurs _parent. 
Le pointeur _parent permet de remonter au pere du clip courant. Si plusieurs pointeurs _parent sont 
utilises, on peut remonter de plusieurs niveaux. Le reste du chemin est compose des differents 
elements (separes par des points) menant a F element cible. 

Exemple de chemin cible relatif : 

(Dans l'exemple ci-dessous, deux clips sont places sur le scenario principal (cl ipFrereAl_nc et 
cl i pFrereBl_mc . )). Le chemin cible est place dans le clip cl i pFrereAl_mc et a pour fonction d'affecter 
la valeur "bonjour" au champ texte dynamique place dans le clip cl ipFrereBl_mc. 

this._parent.cl ipFrereBl_mc.monMessageBl_txt.text=" bonjour" ; 
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Figure 7-8 

Exemple de ciblage absolu de la valeur (.text) d'un champ de texte dynamique (monMessagel _txt) situe dans le 
clip clipEnfantl _mc, lui-meme place dans le clip clipPerel _mc. 
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Figure 7-9 

Exemple de ciblage relatifde la valeur (.text) d'un champ de texte dynamique (monMessageBl _txt) situe 
dans le clip clipFrereBl_mc, depuis un autre clip clipFrereAl _mc place au meme niveau que le precedent. 



Attribuer un nom d'occurrence a chaque objet 

Si vous desirez cibler une propriete ou une methode d'un objet cree dans I'environnement de developpement 
visuel (bouton, champ de texte, clip), il est indispensable d'avoir attribue au prealable un nom d'occurrence a I'objet 
cible (par exemple, le chemin ciblant la propriete _x d'un bouton monBoutonl_btn place sur le scenario prin- 
cipal sera_root.monBoutonl_btn._x). Pour attribuer un nom d'occurrence, il suffit de selectionner I'objet sur la 
scene puis de saisir le nom desire dans le champ du panneau des proprietes nomme Champ d'occurrence. Ne 
confondez pas le nom du symbole et celui attribue a une occurrence de ce dernier. Cependant, il est pratique de 
nommer I'occurrence d'un objet en rappelant le nom de I'objet maitre (clip, bouton...). Nous vous suggerons d'utili- 
ser la convention de nommage qui consiste a ajouter un indice au nom de I'objet maitre pour nommer toutes les 
occurrences de ce dernier (par exemple, vous pouvez utiliser le nom d'occurrence monBoutonl_btn si le bouton 
maitre dont il est issu s'appelle monBouton_btn, voir la figure 7-10). 



Figure 7-10 

Attribution du nom 
d'occurrence monBoutonl _btn 
a un objet bouton issu du clip 
maitre monBouton_btn 
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Structure d'un chemin cible 

Un chemin cible est constitue de trois parties distinctes : 

• Le point de reference du chemin - _root pour un chemin absolu ou thi s pour un chemin relatif ; 

• L'ordre hierarchique des scenarios - liste optionnelle des differentes occurrences des clips 
menant a F element cible, separes par un point et ordonnes selon leur hierarchie ; 

• L'occurrence de l'element cible - suivi eventuellement d'une de ses proprietes ou de ses 
methodes. 

Le tableau 7-56 presente plusieurs structures de chemin cible. 



Tableau 7-56. Exemples de structures d'un chemin cible 



Point de reference 


Ordre hierarchique des scenarios 


Occurrence de l'element cible 




(optionnel) 


(eventuellement suivi d'une propriete 






ou methode a cibler) 


_root. 


monCl ipl_mc. 


nomVari abl e 


thi s ._parent . 


CI ipPerel_mc.cl ipEnfantl_mc. 


monTexte_txt . text 


thi s . _pa rent. _pa rent. 

— 




_x 



Point de reference d'un chemin relatif 

Le point de reference des chemins cibles relatifs doit toujours correspondre : 

• au scenario contenant l'image cle s'il s'agit d'un chemin integre dans une image cle de scenario 
(voir figure 7-11) ; 

• au scenario dans lequel est integre le bouton dans le cas d'un chemin integre dans un gestionnaire 
d'evenements de souris applique a un bouton (voir figure 7-12) ; 

• ou au scenario du clip sur lequel est applique le gestionnaire d'evenements s'il s'agit d'un chemin 
integre dans un gestionnaire d'evenements de clip ou de souris applique a une occurrence de clip 
(voir figure 7-13). 

Dans les trois exemples des figures 7-11, 7-12 et 7-13, un chemin ciblant la valeur d'un meme champ 
texte dynamique place sur le scenario principal est integre a differents endroits d'un clip monCl i pl_mc 
(place sur le scenario principal). 

this ._parent .monTextel_txt . text 

Dans ces trois cas de figure, le point de reference est toujours le scenario du clip monCl ipl_mc. II est 
identifie par les mots-cles : 

thi s ._parent 
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Figure 7-1 1 

Definition du point 
de reference d'un 
chemin cible integre 
dans une image cle 
de scenario du clip 
monClipl _mc 
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Figure 7-12 

Definition du point 
de reference d 'un 
chemin cible integre 
dans un gestionnaire 
d'evenements de 
souris applique a un 
bouton place dans le 
clip monClipl _mc 
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Point de reference d'un chemin absolu 

Le point de reference des chemins cibles absolus est toujours __root. En effet, le scenario principal 
(_root) est le scenario racine de tous les scenarios du projet et permet d'acceder a n'importe quel 
element de 1' animation (voir figure 7-14). 

L'exemple ci-dessous permet de cibler le champ texte monTexte_txt place sur le scenario principal 
depuis un scenario quelconque du projet : 

_root .monTexte_txt 

Dans ce chemin absolu, le point de reference est : 

_root 

Ordre hierarchique des scenarios 

L'ordre hierarchique des scenarios commence par le conteneur place directement apres le point de 
reference, suivi des differents conteneurs enfants suivant leur ordre d' heritage. Les differents conte- 
neurs sont separes par un point et sont identifies par le nom d' occurrence du clip correspondant au 
scenario. Si Felement cible se trouve directement place sur la scene, le chemin cible ne comportera 
pas d' ordre hierarchique de scenarios (exemple : „root.monTexte_txt.text). 

Par exemple, si Felement cible est la valeur d'un champ de texte dynamique monTexte_txt place dans 
un clip cl ipEnfantljnc lui-meme place dans un clip cl ipPerel_mc, le chemin cible absolu est : 

_root.cl ipPerel_mc.clipEnfantl_mc.monTexte_txt.text="bonjour" ; 

dans lequel l'ordre hierarchique des scenarios est : 

cl ipPerel_.mc.cl ipEnfantljnc 
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Figure 7-14 

Definition du point de reference d'un chemin cible absolu. Quel que soit Vendroit oil est integre le chemin, 
il pent etre utilise sans modification (dans Vexemple de la figure, le chemin est integre dans V image cle du clip 
clipEnfantl _mc). 



Occurrence de I'objet cible 

Si un chemin cible (absolu ou relatif) reference une propriete ou une methode d'un objet (bouton, 
champ de texte, Array...), le nom de l'occurrence de cet objet doit etre inclus dans le chemin juste 
avant le nom de la propriete ou de la methode ciblee. 

Par exemple, si vote projet est constitue d'un clip monClipl_mc dans lequel est integre un bouton 
monBoutonl_bm et que vous desirez modifier la position horizontale du bouton, le chemin cible 
absolu est le suivant : 

_root .monCl ipl_mc.monBoutonl_btn ._x=200; 

Dans cet exemple, le chemin cible pointe bien sur l'occurrence du clip vise (monCl ipl_mc) mais 
precise aussi le nom de I'objet dont la propriete doit etre modifiee, soit ici le nom d'occurrence du 
bouton : 

monBoutonl_btn 
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Presentation des differents types de ciblage 

Ciblage absolu d'elements sur le scenario principal (_root) 

Pour cibler un element place sur le scenario principal en utilisant le meme chemin cible depuis 
n'importe quel scenario du projet, il faut utiliser le ciblage absolu. Dans ce cas, le chemin cible est 
construit a partir du point de reference _root suivi d'un point et de Felement a referencer : 

_root .monTexte_txt . text 

Dans l'exemple ci-dessus, Felement cible est la valeur d'un champ texte monTexte_txt place sur le 
scenario principal (_root). 

A noter 

Dans cet exemple, le chemin est place dans un clip monClipEnfantljnc, lui-meme place dans un clip 
monCl i pPerel_mc mais la meme syntaxe pourrait etre utilisee depuis n'importe quel endroit du projet. 



Figure 7-15 

Ciblage absolu d'un element situe sur V animation principale (scenario root) 

Pour illustrer le ciblage de differents types d'elements places sur le scenario principal, voici quelques 
exemples commentes : 

Exemple 1 : cette instruction permet de referencer la variable maVari abl e situee sur le scenario prin- 
cipal et d'affecter sa valeur a une variable locale monMessage placee sur le meme clip que l'instruction 
d' affectation. 

monMessage=_root. ma Variable; 

Exemple 2 : cette instruction affiche le mot "bonjour" dans le champ de texte monTexte place sur le 
scenario principal. Elle peut fonctionner avec la meme syntaxe quel que soit le scenario dans lequel 
elle est executee. 
_root.monTexte_txt.text="bonjour"; 

Exemple 3 : cette instruction permet de deplacer la tete de lecture du scenario principal sur 
Fetiquette etape2. La meme syntaxe peut etre conservee quel que soit 1' endroit ou est execute cet 
ordre. 




5£) .global 



root.monTexte1_txt.text="bonjour"; 

(Chemin place dans 
le scenario de clipEnfant1_mc) 




' n "-™ c I monTexte1_txt 

" (Objet cible, place 

sur le scenario principale :_root ou _levelO) 



_root .gotoAndStop( "etape2" ) ; 
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Ciblage absolu d'elements sur un scenario de clip (_root.monClip_mc) 

Pour referencer un element situe sur le scenario d'un clip a Faide d'un chemin absolu, il suffit d'ajou- 
ter au pointeur _root Fordre hierarchique des scenarios menant a F element cible en mentionnant 
toutes les occurrences des clips ordonnees par heritage puis le nom de 1' element. 

Exemple : 

_root.monCl ipPerel_mc. monCl ipEnfantl_mc.monTexte_txt.text 

Dans l'exemple ci-dessus Felement cible est la valeur d'un champ de texte dynamique monTexte_txt 
place sur un clip monCl i pEnf antl_mc lui-meme place dans un autre clip monCl i pPereljc. 



A noter 

Dans cet exemple, le chemin est place dans un clip monCl ipEnfantAljnc, lui-meme place dans un autre clip 
monCl ipPereAl_mc mais la meme syntaxe pourrait etre utilisee depuis n'importe quel endroit du projet. 



0 .glow 

_root.clipPereB1_mc.clipEnfantB1_mc.monTexte_txt.text="bonjour"; 

53 iT" - (Chemin place dans 

H J"*****"*'-'" \^^-^"^ ^ scenario de clipEnfantA1_mc) 

0 _3 >*«*><:lipP«rtBl_mc 

B !_] JevelOilipPereBl.mcx:lipEnfintBI_mc 



.monTexte_txt 

(Objet cible, place sur 



1*-""^ luoiei cioie. piace sur 

le»«IO.clipPereBi mcckpEnfanlBl mc jtionTexle lit , , ' ' ._ ^ 

— = = — 1 le scenano auxiliaire :clipEnfantB1 mc) 



Figure 7-16 

Ciblage absolu d'elements situes sur une animation auxiliaire (clip auxiliaire) 



Voici quelques exemples commentes correspondant a ce type de ciblage : 

Exemple 1 : cette instruction deplace sur Faxe horizontal le clip monCl ipl_mc place sur le scenario 
principal. Cette instruction peut etre executee avec la meme syntaxe dans toutes les animations du 
projet. 

_root. monCl ipl_mc._x ++; 

Exemple 2 : cette instruction arrete Fanimation du clip monCl ipl_mc place sur le scenario principal. 
Elle peut etre executee avec la meme syntaxe dans toutes les animations du projet. 

| _root. monCl ipl_mc.stop( ) ; 

Exemple 3 : cette instruction affiche le mot "bonjour" dans le champ de texte monTexte_txt place sur 
le clip monCl i pl_mc. Cette instruction peut etre executee avec la meme syntaxe dans toutes les animations 
du projet. 

_root. monCl ipl_mc.monTexte_txt.text="bonjour" ; 
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Ciblage relatif d'elements en local (this) 

Si Ton utilise un chemin cible contenant uniquement le nom de l'element a referencer (par exemple : 
monTexte_txt . text), Flash cible de maniere implicite l'element portant ce nom situe dans l'animation 
en cours. 

Dans l'exemple ci-dessous, la valeur "bonjour" sera affectee a la valeur du champ de texte dynami- 
que monTexte_text s'il est situe sur la meme animation que celle ou est saisie l'instruction 
d' affectation : 

monTexte_txt.text="bonjour" ; 

Cependant, Flash suggere d'utiliser le pointeur this afin d'indiquer d'une maniere explicite que 
l'element cible se trouve dans la meme animation. La ligne de code ci-dessous realise la meme affec- 
tation que celle de l'exemple precedent : 

this .monTexte_txt. text=" bonjour" ; 



this.monTexte_txt.text="bonjour"; 

(Chemin place dans I'image cle du 





_UvtlOxlipP*rtI_mc.cfcpEnf*nH_mc *^ 






ST] _ltvtlOxlipP«r*l_mc.cSpEnf*Pitl_mc*f»onTt)(t*_Ul 













. monTexte_txt 

(Objet cible, place sur 
le scenario courant :clipEnfant1_mc) 



Figure 7-17 

Ciblage local d'elements situes sur l'animation courante 



Evidemment, il est possible de cibler de la meme maniere tout type d' element situe sur l'animation 
en cours. On peut ainsi modifier les proprietes d'un objet (_x, _y, _alpha...) ou appeler une fonction 
ou une methode d' objet (pi ay( ), stop( )...) comme dans les exemples commentes ci-dessous. 

Exemple 1 : cette instruction modifie la position horizontale du clip dans lequel elle est executee (clip 
courant). 

| this._x=200; 

Exemple 2 : cette instruction affecte a la variable monNom le contenu du champ texte monChamp_txt 
situe sur le meme clip. Cette ligne de code doit etre executee sur le clip oil se trouve le champ texte. 

thi s .monNom=this .monChamp_txt. text ; 

Exemple 3 : cette instruction demarre l'animation courante si elle est executee sur le scenario 
courant. 

this.playO; 

Exemple 4 : cette instruction permet de rendre invisible le clip monCl ipEnfantl_mc place dans 
l'animation courante (il ne sera plus affiche sur la scene). Cette ligne de code doit etre executee 
dans l'animation courante du clip concerne. 

this.monCl ipEnfantl_mc._visible=false; 
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Exemple 5 : ces instructions permettent de deplacer le clip courant lorsque le bouton de la souris est 
enfonce. Elles doivent etre executees dans le scenario du clip conceme. 

on (press) { 
startDrag(this) ; 

} 

on (release) ( 
stopDragt ) ; 

} 

Ciblage relatif d'elements sur un scenario parent (_parent) 

Nous avons presente precedemment le ciblage relatif d'un element dans le cas ou il se situe dans la 
meme animation que F instruction d'appel (en prefixant le chemin par le pointeur thi s ou en n'indi- 
quant aucun pointeur). II existe un autre pointeur de ciblage relatif qui permet d'indiquer que le point 
de reference a partir duquel est construit le reste du chemin se trouve au niveau de F animation parente. 
Pour construire un chemin cible relatif de ce type, il suffit d'ajouter au pointeur _parent le chemin 
menant a Felement cible en mentionnant toutes les occurrences des clips ordonnees par heritage. 

Dans Fexemple ci-dessous, la valeur "bonjour" sera affectee a la valeur du champ de texte dynamique 
monTexte_text s'il est situe sur le scenario parent de Fanimation courante ou est saisi Finstruction 
d' affectation : 

_pa rent. monTexte_txt.text=" bonjour" ; 

Lors de Futilisation du pointeur _pa rent, Flash suggere d'ajouter le prefixe this arm d'indiquer d'une 
maniere explicite que Felement cible est parent de Fanimation courante. La ligne de code ci-dessous 
realise la meme affectation que celle de Fexemple precedent : 

this ._parent.monTexte_txt.text=" bonjour" ; 



Q _giob.i this._parent.monTexte_txt.text="bonjour"; 

!£| j,v«io / (Chemin place dans I'image cle du 

scenario de clipEnfantl mc) 

_monTexte_txt 

(Objet cible, place sur 
le scenario parent :clipPere1_mc) 

Figure 7-18 

Ciblage relatif d' elements situes sur une animation parente (clip parent) 





!E] _Uv«IO.clipP*r*l_n>c.cfcpEr»finlljr»c 




| t i. Jeuel0.clipPereI_mc.rnonTe.re_Ut 





Voici quelques exemples commentes correspondant a ce type de ciblage : 

Exemple 1 : cette instruction additionne deux variables situees dans Fanimation parente du clip 
courant et memorise le resultat dans une variable monResul tat placee dans le clip courant. Attention ! 
Cette instruction ne peut pas etre executee si les variables additionnees ne sont pas situees dans le clip 
parent. 

this. monResul tat=this._parent.maVariablel+ this._parent.maVariable2; 
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Exemple 2 : cette instruction applique une rotation de 45° au clip monCl ipFrerel_mc place dans la 
meme animation parente que le clip courant (le clip cible est done le clip frere du clip courant). 
Attention ! Cette instruction ne peut pas etre executee si le clip vise ne se trouve pas dans le clip 
parent. 

this._parent.monCl ipFrerel_mc._rotation=45; 

Exemple 3 : cette instruction regie Falpha du bouton monBoutonl_btn place dans l'animation 
parente du clip courant. Attention ! Cette instruction ne peut pas etre executee si le bouton cible n'est 
pas situe dans le clip parent. 

this ._pa rent .monBoutonl_btn ._al pha=50; 

Exemple 4 : cette instruction permet de cibler une variable monMessage situee dans un clip situe deux 
niveaux au-dessus de l'animation courante (l'animation ciblee est done en quelque sorte la grand- 
mere de l'animation courante). Attention ! Cette instruction ne peut pas etre executee si la variable 
ciblee n'est pas situee dans le clip grand-pere. 

thi s .maVariabl e= this ._pa rent ._pa rent .monMessage; 

Ciblage d'elements sur un niveau (JeveH) 

Flash permet de charger plusieurs fichiers SWF simultanement dans un meme projet a l'aide de 
l'instruction loadMovieNumt ). Afin de distinguer les elements des fichiers SWF entre eux, chaque 
fichier doit etre place a un niveau different. Le premier fichier SWF appele est automatiquement 
charge au niveau 0 (e'est notamment ce qui se passe lorsqu'on appelle un fichier SWF dans 
Flash Player, _levelO et _root etant dans ce cas equivalents). Les differentes animations se 
superposent les unes aux autres et il est possible de gerer la place d'une animation SWF (premier 
plan ou arriere-plan) selon le niveau oil elle est chargee (un peu comme avec les caiques dans un 
scenario). 

Chaque fichier SWF appele possede son propre scenario principal (_root) et il peut etre utilise 
comme pointeur au sein du niveau pour cibler un element interne. Si Ton desire cibler un element 
d'un fichier SWF place a un autre niveau, il faut utiliser un pointeur specifique correspondant au 
niveau cible. Par exemple, le pointeur _1 evel 2 permet de cibler le scenario principal du niveau 2, 
de meme que le pointeur _JevelO correspond au pointeur „root du premier fichier SWF appele. 
Pour s'en convaincre, il suffit d'afficher le pointeur _root depuis l'image cle 1 d'un fichier SWF pour 
constater que le nom affiche dans le panneau Sortie sera _1 evel 0 et non __root. 

trace(_root) ; 

Si vous executez l'instruction traceO ci-dessus depuis une image cle du scenario principal, le 
panneau Sortie affiche le nom du pointeur du niveau 0 soit : 

| JevelO 

En utilisant un pointeur de niveau (J evel 1 ou _1 evel 2 , par exemple), vous pouvez cibler un element 
place sur le scenario principal de ce niveau mais aussi tous les elements places sur les differents clips 
qu'il peut contenir. 
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_global 
levelO 



Je velO .clipA jout l_mc 



knell' 



level2.monTexte txt 



_level2.monTexte_txt.text+="bonjour "; 

/ (Chemin place dans le gestionnaire d'evenements 
du clip clipEnfant1_mc du niveau 0 : JevelO) 

monTexte_txt 

(Objet cible, place sur 
le scenario principal du niveau 2 : _level2) 



Figure 7-19 

Ciblage d 'elements situes sur une animation d'un niveau different (scenario principal du niveau 2) 

Pour illustrer ce type de ciblage, nous allons creer un petit projet compose de deux fichiers SWF. L'un, 
nomme principal .swf, est le fichier appele initialement, alors que le second, nomme secondaire.swf, 
est charge par le premier fichier dans le niveau 2 de Flash Player. 

1. Creez le fichier secondaire en ouvrant un nouveau document et en l'enregistrant sous le nom 
secondaire.fi a. 

2. Dans F animation principale de ce fichier, creez un champ texte dynamique positionne au centre 
de la scene dont l'occurrence est nommee monTexte_txt. Enregistrez le fichier et publiez-le sous 
le meme nom, soit secondaire.swf. 

3. Ouvrez maintenant un nouveau document Flash et enregistrez-le sous le nom principal . f 1 a. 
Apres sa publication, le fichier principal .swf ainsi cree sera Fanimation principale du projet 
(chargee au niveau 0). 

4. Placez-vous sur Fimage cle 1 du scenario principal et saisissez Finstruction suivante afin de charger 
le fichier secondaire.swf dans le niveau 2 : 

1 oadMovieNum( "secondai re. swf " ,2) ; 

5. Creez ensuite un clip d'occurrence cl ipAjoutl_mc sur le scenario principal et appliquez-lui le 
gestionnaire d'evenements de souris ci-dessous : 

I on (press) { 

_1 evel 2.monTexte_txt . text+="bonjour " ; 

I ) 

6. Ce gestionnaire d'evenements de souris permet (a chaque clic de souris sur le clip) d'ajouter le 
mot "bonjour" a la valeur precedente du champ de texte monTexte_txt situe dans Fanimation 
chargee au niveau 2. Enregistrez Fanimation dans le meme repertoire que le fichier precedent et 
passez dans Fenvironnement de test pour verifier le bon fonctionnement du projet Flash. 

7. Le clip Ajout bonjour du fichier pri nci pal . swf ainsi que le champ de texte du fichier secondai re . swf 
doivent apparaitre dans la fenetre de Fenvironnement de test. A chaque clic sur le clip Ajout 
bonjour (charge dans le niveau 0), le mot "bonjour" (charge dans le niveau 2) doit s'ajouter a la 
valeur precedente (voir figure 7-20). 
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Figure 7-20 

Exemple de ciblage entre deux niveaux d'un mime projet 



Ciblage d'elements globaux (_global) 

La portee d'un element Flash (qu'il s'agisse d'une simple variable, d'une fonction ou d'un objet) 
delimite sa zone d'utilisation dans un programme. 

Par defaut, un element Flash est local et sa portee est limitee au bloc de script dans lequel il a ete 
declare (zone delimitee par les accolades { et }) ou a tout son scenario s'il s'agit d'un element declare 
dans une image cle d'un scenario. 

A l'inverse, un element Flash global reste accessible dans tous les scenarios d'une animation. Vous 
pouvez done le cibler directement (sans preciser son chemin cible) quel que soit le scenario dans 
lequel vous vous trouvez. 

Utilisation d'une variable globale dans des scenarios differents 
Pour creer un objet global, il suffit de le declarer en ajoutant a son nom le prefixe _gl obal . 
Exemple de creation d'une variable globale : 
_gl obal .maVariableGl obal e=" bonjour" ; 
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Une fois creee, la variable globale peut etre referencee de la meme maniere depuis n'importe quel 
scenario d'une animation comme l'illustrent les deux exemples ci-dessous (attention : contrairement 
aux differents types de ciblage presentes precedemment, le mot-cle _global n'est pas utilise dans la 
syntaxe du chemin cible) (voir figure 7-21) : 

monTextel_txt.txt=maVariableGlobale; // Appel depuis un clip 
I monTexte2_txt.txt =maVariableGlobale; // Appel depuis le scenario principal. 



£3] .global 



monTexte1_txt.text=maVariableGlobale; 

(affectation de la valeur du champ 
monTexte1_txt situe dans le clip 
monClipl _mc avec la variable globale 
maVariableGlobale) 

monTexte2_txt.text=maVariableGlobale; 

(affectation de la valeur du champ 
monTexte2_txt situe dans le scenario 
principal _root avec la variable 
globale maVariableGlobale) 



Figure 7-21 

Exemple de ciblage d'un element global depuis le scenario principal et depuis un scenario auxiliaire 
monClipl _mc 




A titre de comparaison, voici la syntaxe de la declaration (sur le scenario principal puis sur le scena- 
rio d'un clip) et du ciblage absolu de cette meme variable, declaree cette fois-ci comme variable 
locale, depuis un scenario quelconque : 

Exemple avec une declaration sur le scenario principal : 
maVariableLocale ="bonjour"; 

// Declaration de la variable sur le scenario principal 
motAccueil=_root. maVariableLocale; 
// Appel de la variable depuis un scenario quelconque 

Exemple avec une declaration sur le scenario d'un clip : 

maVariableLocale ="bonjour"; 

// Declaration de la variable sur le scenario du clip monClipl_mc 
motAccueil=_root.monClipl_mc. ma Variable Locale; 
// Appel de la variable depuis un scenario quelconque 

Exemple 1 : 

II en est de meme pour tous les objets : 

_global .monObjetGlobal_array=new Array ( "vert" , "rouge" , "bleu" ) ; 
// Creation d'un objet tableau global 
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On peut appeler l'une de ses methodes ou utiliser une propriete depuis differents scenarios avec la 
meme syntaxe : 

monObjetGlobal_array.sort( ) ; // Appel a la methode sortO depuis le scenario principal 
monObjetGlobal_array.sort( ) ; // Appel a la methode sortO depuis un clip 

Exemple 2 : 

Les fonctions peuvent de la meme maniere etre declarees comme fonctions globales (l'utilisation des 
fonctions utilisateur globalisees sera detaillee dans le chapitre 10 consacre a la programmation 
structuree en ActionScript) : 

_g 1 o b a 1 .maFonctionGlobale=function() { 

// Ici le bloc d'actions de la fonction globale 

I > 

On peut ensuite referencer la fonction avec la meme syntaxe a partir de n'importe quel scenario, a 
Finstar des fonctions Flash integrees : 

maFonctionGlobaleO; 

// Appel d'une fonction globale depuis un clip 
| maFonctionGlobaleO; // Appel d'une fonction globale depuis le scenario principal 

Exemple 3 : 

Dans certains cas, il est interessant de convertir un objet local en objet global ann de pouvoir le mani- 
puler dans tous les scenarios de F animation. Par exemple, si vous desirez controler facilement une occur- 
rence de clip monClip2_mc, il est possible de le convertir en element global a Faide de Finstruction 
suivante : 

_g 1 o b a 1 .monClipGlobal_mc=_root.monClipl_iTic.monClip2_nic; 

II suffit par la suite d'utiliser son nom global pour le controler depuis tous les scenarios du projet 
comme dans Fexemple ci-dessous : 

monCli pGlobal_mc.pl ay(); 

Utilisation d'une variable globale dans des niveaux differents 

Nous venons de voir qu'une variable globale peut etre utilisee dans tous les scenarios d'une anima- 
tion en se referant uniquement a son nom (c'est-a-dire sans utiliser son chemin cible). Elle peut etre 
utilisee de la meme maniere depuis les differents niveaux d'un projet. 

Pour vous le demontrer, nous allons creer un petit projet compose de deux fichiers SWF. L'un, 
nomme pri nci pal 2 . swf , est le fichier appele initialement, alors que le second, nomme secondai re2 . swf , 
est charge par le premier fichier au niveau 2 de Flash Player. 

1. Creez le fichier secondaire en ouvrant un nouveau document et en Fenregistrant sous le nom 
secondaire2.fla. 

2. Dans F animation principale de ce fichier, creez un champ texte dynamique positionne au centre 
de la scene dont Foccurrence est nommee monTexte_txt. Enregistrez le fichier et publiez-le sous 
le meme nom, soit secondai re2. swf. 
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3. Ouvrez maintenant un nouveau document Flash et enregistrez-le sous le nom principal 2. f la. 
Apres sa publication, le fichier pri nci pal . swf cree sera l'animation principale du projet (chargee 
au niveau 0). 

4. Placez-vous sur la scene du scenario principal et creez un clip d'occurrence cl iplnitl_mc. 

5. Appliquez-lui le gestionnaire d'evenements ci-dessous qui sera appele des le chargement du clip : 

onClipEvent (load) { 
_gl obal .maVari abl eGl obal e=" bonjour" ; 
loadMovieNum("secondaire2.swf" ,2) ; 
1 

6. Ce gestionnaire d'evenements permet de declarer la variable globale maVariabl eGl obal e et de lui 
affecter le mot "bonjour" puis de charger l'animation secondaire dans le niveau 2. Enregistrez 
l'animation dans le meme repertoire que le precedent fichier et passez dans l'environnement de 
test avec debogage (Ctrl + Maj + Entree) pour verifier le bon fonctionnement de votre projet. 

7. Dans la fenetre de debogage, cliquez sur le niveau global (_gl obal ) et selectionnez l'onglet Varia- 
bles afin de suivre l'initialisation de la variable globale lors du chargement du clip. Cliquez 
ensuite sur la fleche verte de la fenetre du debogueur afin de demarrer l'animation principale. 
La variable globale (initialisee avec "bonjour") apparait dans l'onglet Variables ainsi que dans le 
champ texte de l'animation secondaire (voir figure 7-22). 



/ Macromedia Haih Professional B [principal. fta] 




Figure 7-22 

Exemple d 'utilisation d'une variable globale entre deux niveaux d'un meme projet 
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Convention de nommage d'une variable globale 

Apres ces differents exemples, vous comprendrez aisement qu'il est interessant de declarer en 
element global tout element frequemment utilise dans differents scenarios du projet. Cependant, il est 
primordial de s'assurer que le nom de Pelement global n'a aucune chance de rentrer en conflit avec 
un des elements portant le meme nom utilise dans un des scenarios de l'animation. Pour eviter ce 
genre d'erreur, le mieux est de definir une convention de nommage specifique pour tous les elements 
globaux. 

Par exemple, nous pourrions convenir d'utiliser le prefixe glob_ devant tous les noms d'elements 
globaux : 

var _global .glob_maVariable="bonjour"; 

II n'y a plus aucun risque de conflit, meme si une autre variable maVariable existe dans l'un des 
scenarios de l'animation. 

Ciblage groupe d'elements (with) 

Lorsque plusieurs proprietes ou methodes d'un meme objet doivent etre ciblees, utilisez Faction 
with : cela vous epargne de repeter le chemin cible a chaque appel. Par exemple, pour modifier les 
proprietes _y, _x et _al pha du clip monCl i p_mc situe sur le scenario principal, il faudrait theoriquement 
ecrire les trois lignes de code suivantes : 

_root.monCl ip_mc._x=200; 
_root.monCl ip_mc._y=100; 
_root.monCl ip_mc._alpha=50; 

L' autre alternative consiste a utiliser Taction with avec la syntaxe suivante : 

with(_root.monCl ip_mc){ 
_x=200; 
_y=100; 
_alpha=50; 

} 

Bien sur, dans F exemple ci-dessus, le gain de temps et de lisibilite du code n'est pas flagrant, mais si 
le chemin cible est complexe ou si les references a Fobjet sont nombreuses, cette syntaxe devient tres 
interessante. 



A noter 

L'action with n'est pas limitee au chemin cible des clips. Elle peut egalement etre utilisee avec de nombreux objets 
ActionScript (boutons, champs de texte...). 



Comparatif des differents types de ciblage 

Nous venons de vous presenter les differentes manieres de cibler un element Flash. Un meme 
element peut souvent etre reference a Faide de plusieurs types de ciblage. II faut done connaitre les 
avantages et inconvenients de chacun afin de choisir le plus approprie. 
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Le tableau 7-57 (en reference a la figure 7-23) liste les differentes solutions de ciblage possibles 
selon le scenario dans lequel est integre le chemin cible et la place de F element cible. II resume tous 
les types de ciblage etudies dans cette partie et vous permet de les transposer facilement a votre 
projet. 



Figure 7-23 

Comparatifdes differentes 
solutions de ciblage. 



y\ _global maVarG 

S) JevelO (5) maVarO 

!_S) JevelO. Clip A ® maVarA 
^) JevelO. ClipB (§) ™VarB 
Jevel2 (2) ™Var2 
5£) Jevel2.ClipC (5) maVarC 



Tableau 7-57. Comparatif des differentes alternatives de ciblage 



Variables a 
cibler 


maVarO 


maVarA 


maVarB 




maVar2 


maVarC 


maVarG 


Depuis le 
scenario 0 


this.maVarO 

JevelO.maVarO 

_root.maVarO 


this.Cl IpA.maVarA 
_root.ClipA.maVarA 
JevelO. CI i pA.maVarA 


this. ClipB. maVarB 
_root. ClipB. maVarB 
JevelO. ClipB. maVarB 


Jevel2.maVar2 


Jevel2.ClipC.maVarC 


maVarG 


Depuis le 
scenario A 


thi s._parent .maVarO 

JevelO.maVarO 

_root.maVarO 


this.maVarA 
_root .CI IpA.maVarA 
JevelO. CI i pA.maVarA 


thi s._pa rent. ClipB. maVarB 
_root. ClipB. maVarB 
JevelO. ClipB. maVarB 


Jevel2.maVar2 


Jevel2.ClipC.maVarC 


maVarG 


Depuis le 
scenario B 


thi s._parent .maVarO 

JevelO.maVarO 

_root.maVarO 


thi s ._parent . CI ipA.maVarA 
_root .CI IpA.maVarA 
JevelO. CI ipA.maVarA 


this. maVarB 
_root. ClipB 
JevelO.Cli 


.maVarB 
)B. maVarB 


Jevel2.maVar2 


Jevel2.ClipC.maVarC 


maVarG 


Depuis le 
scenario 2 : 


JevelO.maVarO 


JevelO. CI i pA.maVarA 


JevelO.Cli 


)B. maVarB 


this.maVar2 

_root.maVar2 

Jevel2.maVar2 


this.ClipC.maVarC 

_root.ClipC.maVarC 

Jevel2.ClipC.maVarC 


maVarG 


Depuis le 
scenario C 


JevelO.maVarO 


JevelO. CI ipA.maVarA 


JevelO.Cli 


)B. maVarB 


this._parent.maV 
ar2 

_root.maVar2 


this.maVarC 
_root . CI l" pC .maVarC 
Jevel2.ClipC.maVarC 


maVarG 



.level2.maVar2 



Avantage des chemins cibles relatifs 

Les chemins cibles relatifs (pointeurs thi s ou _parent) permettent le emplacement d'un ensemble de scenarios 
d'un endroit a I'autre du projet, voire dans un autre projet, tout en preservant les liens entre les scenarios de 
I'ensemble. 



Les fondamentaux de la programmation 

Partie II 



Avantage des chemins cibles absolus 

Les chemins cibles absolus prennent comme reference la racine de I'animation principale (_root). Par conse- 
quent, leur syntaxe est la meme quel que soit le scenario dans lequel est integre le chemin. lis sont done appreciates 
pour cibler un element a partir d'un meme script (une fonction, par exemple) execute dans des scenarios differents 
du projet. 



Avantage des ciblages d'elements sur un niveau 

Des qu'un projet devient consequent, il est interessant de le decouper en plusieurs fichiers SWF, charges a des 
niveaux differents. Dans ce cas, I'utilisation des pointeurs de niveaux (_1 evel 1, _1 evel 2...) permet d'etablir des 
interactions entre les elements de ces differents fichiers. Cependant, au sein d'un meme fichier SWF, il est prefera- 
ble d'utiliser des chemins relatifs ou absolus (thi s, _pa rent ou _root) et non le pointeur de niveau _1 evel 1 si le 
fichier est charge dans le niveau 1 , par exemple, afin de ne pas perturber le fonctionnement des scripts si le fichier 
SWF devait etre charge dans un autre niveau. 



Avantage des elements globaux 

Les elements references globalement (a I'aide de _gl obal ) peuvent ensuite etre utilises dans tous les scenarios 
d'un meme projet (quel que soit leur niveau) sans qu'il soit necessaire de preciser leur chemin cible. II est done tres 
interessant de declarer en element global les elements frequemment references depuis differents scenarios d'un 
projet. 



Partie III 



Programmation 
structures 
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Introduction 
a la programmation structuree 



Contrairement a la programmation sequentielle (dans laquelle des blocs d' instructions sont parcoums 
l'un apres F autre), la programmation structuree permet de creer des programmes interactifs qui 
reagissent differemment selon des evenements (structures de choix) ou executent d'une maniere 
repetitive le meme bloc d' instructions (structure de boucle). 

L'usage des fonctions permet en outre de mieux structurer le programme en le fractionnant en de 
multiples petits blocs d' instructions simples reutilisables dans d'autres contextes. 

Dans ce chapitre, nous vous presenterons les principales notions de la programmation structuree 
grace a des exemples d'algorithmes simples. Les deux chapitres suivants vous permettront d'appliquer 
ces concepts aux langages de programmation PHP et ActionScript. 

Notion d'algorithme 

La programmation structuree, c'est aussi une methodologie qui conduit le programmeur a developper 
une application par la construction methodique d'un algorithme. En effet, « bien programmer » ne 
consiste pas seulement a realiser une application qui fonctionne mais surtout a la structurer afin 
qu'elle soit facile a maintenir. Si Falgorithme a ete elabore avec soin et methode avant d'etre traduit 
en programme, on pourra ensuite facilement modifier ce dernier sans remettre en cause sa structure. 

Un algorithme est une description de 1' application utilisant des instructions proches du langage parle 
(interpretables par tous sans connaissance prealable) qui permet d'elaborer une premiere structure du 
programme a partir de l'analyse de son cahier des charges. Lalgorithme est universel et independant 
de tous les langages de programmation ; il peut done etre facilement traduit en instructions du 
langage de programmation final (AS ou PHP dans le cadre de cet ouvrage). 
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La premiere partie de l'algorithme est destinee a declarer les variables utilisees par le programme. 
Dans un algorithme, on distingue deux families d' instructions : 

• Les instructions de base, qui permettent la manipulation d'une variable (affectation, lecture, 
ecriture...). 

• Les instructions de structuration, qui indiquent comment doivent s'enchainer ces instructions de 
base. 

Les instructions de structuration utilisent des expressions de condition pour definir comment doivent 
s'enchainer les instructions (structure de choix ou de boucle). Lors du test, ces expressions de condi- 
tion s'executent et renvoient une valeur booleenne (vrai ou faux) qui permet a la structure de prendre 
la bonne decision. 

Les operateurs utilises dans ces expressions sont les suivants : 

A = = B : teste si A est egal a B. 

A ! = B : teste si A est different de B. 

A > B : teste si A est strictement superieur a B. 

A < B : teste si A est strictement inferieur a B. 

A >= B : teste si A est superieur ou egal a B. 

A <= B : teste si A est inferieur ou egal a B. 

Pour illustrer la creation d'un algorithme, prenons l'exemple d'un programme de soustraction de 
deux nombres A et B. Les valeurs de ces deux nombres sont saisies au clavier par l'utilisateur : 

#Declaration des variables 
A : entier 
B : entier 
RES : entier 
#Debut du programme 

Ecrire ("Indiquez la premiere valeur :") 
Lire (A) 

Ecrire ("Indiquez la seconde valeur :") 
Lire (B) 
RES=A-B 
Ecrire (RES) 
#Fin du programme 

Ce petit programme se passe de commentaire et c'est d'ailleurs Finteret d'un algorithme : il peut etre 
compris par tous sans connaissance prealable ! 



Structures de choix 

Les structures de choix permettent de traiter des blocs differents selon la valeur renvoyee par 
F expression de condition. Les expressions de condition sont constitutes de variables, de constantes 
et d'operateurs. Lors de leur execution, elles renvoient une valeur booleenne (vrai ou faux). En fonction 
de celle-ci, un bloc different sera execute par le programme. 
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Structures de choix si()-alors-finSi 

La structure si ( )-alors-f1nSi est la plus simple des structures de choix. Elle permet d'executer un 
bloc destructions uniquement si la condition est vraie (voir figure 8-1). Les instructions a traiter 
sont rassemblees dans un bloc delimite par al ors et f i nSi . 

L'exemple ci-dessous permet d'afficher le texte le resultat est positif : suivi de la valeur du 
resultat uniquement s'il est positif : 

#Declaration des variables 
A : entier 
B : entier 
RES : entier 
#Debut du programme 

Ecrire ("Indiquez la premiere valeur :") 
Lire (A) 

Ecrire ("Indiquez la seconde valeur :") 
Lire (B) 
RES=A-B 

Si (RES>=0) alors 

Ecrire ("Le resultat est positif :") 
Ecrire (RES) 

f inSi 

#Fin du programme 



Figure 8-1 

Structure de choix 
si( )-alors-finSi 




Si (condition) 




BLOC 1 


\ 








r 



alors 



instruction 1 
instruction2 



finSi 



Structures de choix si()-alors-sinon-finSi 

La structure de choix precedente ne traite que le cas oil la condition est vrai e ; dans le cas contraire, 
aucune instruction n'est executee. Avec la structure de choix si ( )-alors-sinon-finSi, il est possible 
de traiter les deux cas et d'executer un bloc destructions different selon la valeur retournee par 
l'expression de condition (voir figure 8-2). 
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L'exemple ci-dessous perniet d'afficher le resultat dans les deux cas mais en precisant si le resultat est 
positif ou negatif : 

#Declaration des variables 
A : entier 
B : entier 
RES : entier 
#Debut du programme 

Ecrire ("Indiquez la premiere valeur :") 
Lire (A) 

Ecrire ("Indiquez la seconde valeur :") 

Lire (B) 

RES=A-B 

si (RES>=0) alors 

Ecrire ("Le resultat est positif :") 
sinon 

Ecrire ("Le resultat est negatif :") 

finSi 

Ecrire (RES) 
#Fin du programme 



Figure 8-2 

Structure de choix 
si( )-alors-sinon-finSi 



c si (condition) 



si (condition) 




alors 



BLOC 1 



instruction11 
instruction^ 



BLOC 2 



sinon 

instruction21 
instruction22 



finSi 



Structures de choix avec si()-alors-sinonSi()-finSi 

Dans le cas oil plusieurs conditions doivent etre testees, il est possible d'utiliser la structure 
si ( )-alors-sinonSi ( )-sinon-finSi. L'instruction sinonSK) introduit une nouvelle condition et 
pourra etre repetee autant de fois qu'il y aura de cas a tester (voir figure 8-3). 
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L'exemple ci-dessous permet de tester trois cas differents : si le resultat est strictement positif, si le 
resultat est egal a zero ou s'il est negatif. Dans les trois cas, un message en rapport sera affiche, suivi 
de la valeur du resultat : 

#Declaration des variables 
A : entier 
B : entier 
RES : entier 
#Debut du programme 

Ecrire ("Indiquez la premiere valeur :") 
Lire (A) 

Ecrire ("Indiquez la seconde valeur :") 

Lire (B) 

RES=A-B 

si (RES>=0) alors 

Ecrire ("Le resultat est positif :") 
sinonSi (RES==0) 

Ecrire ("Le resultat est nul :") 
sinon 

Ecrire ("Le resultat est negatif :") 

f inSi 

Ecrire (RES) 
#Fin du programme 



Figure 8-3 

Structure de choix 

si( )-alors-sinonSi( )-finSi 




BLOC 1 




BLOC 2 



BLOC 3 



si (condition 1 !) 

alors 

instruction 11 
instructions 



sinonSi(condition2) 

instruction21 
instruction22 



sinon 



instruction31 
instruction32 

finSi 
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Structures de choix avec test()-cas()-finCas-finTest 

Si toutes les expressions de condition sont des tests d'egalite et que le nombre de cas a tester est 
important, il faut avoir recours a une autre solution. La structure teste )-cas( )-finCas-finTest 
est specialement adaptee au test de cas multiples (voir figure 8-4). L' instruction test( ) permet d'indi- 
quer quelle variable doit etre testee, alors que les instructions cas( ) indiquent les valeurs des diffe- 
rents cas possibles et introduisent les blocs a executer si la variable correspond a cette valeur (chaque 
bloc se termine par une instruction f inCas). 



Figure 8-4 

Structure de choix 
test( )-cas( JfinCas-finTest 



r==vah 



var==va!2 



BLOC 1 — , 



BLOC 2 — 



f FAUX 




>y VRAI 




=val3/> 


BLOC 3 


FAUX 






BLOC 





default 



test(var) 

cas(vaM) 

instruction 11 
instructions 

finCas 



cas(val2) 

instruction21 
instruction22 

finCas 

cas(val3) 

instruction31 
instruction32 

finCas 

sinon 

instruction41 
instruction42 



finTest 



L'exemple ci-dessous permet de tester la langue choisie par Futilisateur a Faide de la structure test( ) - 
cas( )-f inCas-finTest. Un message souhaitant Bonjour dans la langue choisie est ensuite affiche : 

#Declaration de la variable 

LG : texte 

#Debut du programme 

Ecrire ("Indiquez la langue desiree parmi les choix ci-apres : fr, en, es ou de") 
Lire (LG) 
test (LG) 
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cas( "f r" ) 

Ecri re 

finCas 
cas( "en" ) 

Ecri re 

finCas 
cas( "es" ) 

Ecri re 

finCas 
cas( "de" ) 

Ecri re 

finCas 

f inTest 

#Fin du programme 
Si l'utilisateur saisit en, le programme affichera le texte suivant : 
Hello 

Structures de boucle 

La structure de boucle permet d' executer un bloc d' instructions autant de fois que la condition de 
boucle renvoie la valeur vrai . On peut ainsi executer le meme bloc d'une maniere repetitive selon les 
besoins du programme. Pour que la boucle puisse fonctionner, il faut commencer par initialiser une 
variable specifique appelee « compteur de boucle » qui aura pour fonction de compter le nombre de 
fois que le bloc (appele « corps de boucle ») a ete execute. II faut ajouter une instruction decremen- 
tation (ajoute une unite) ou de decrementation (retranche une unite) dans le corps de boucle afin que 
le compteur de boucle puisse evoluer d'un tour a 1' autre et tendre progressivement vers la valeur 
limite de la condition de boucle. 

Deux structures differentes peuvent etre utilisees selon que Ton desire ou pas executer au moins une 
fois le corps de boucle. 



( "Bonjour" ) 
("Hello") 
("Hoi a") 
("Guten Tag") 



Structures de boucle avec boucleSiQ-finBoucle 

Avec la structure boucleSi ( )-finBoucle, le corps de boucle ne sera pas execute si la condition de 
boucle est fausse des le depart (voir figure 8-5). 

Dans Fexemple ci-dessous, le programme executera trois fois le corps de boucle : 

#Declaration et initialisation du compteur de boucle 

COMPTEUR : entier 

C0MPTEUR=3 

#Debut du programme 

boucleSi (C0MPTEUR>0) 

Ecri re ("Nombre de tours :") 

Ecrire (COMPTEUR) 

C0MPTEUR=C0MPTEUR-1 

finBoucle 

Ecrire ("Fin du programme") 
#Fin du programme 
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Informations affichees par le programme : 

Nombre de tours : 3 
Nombre de tours : 2 
Nombre de tours : 1 
| Fin du programme 

Dans ce second exemple, le programme n' execute pas le corps de boucle car la condition de boucle 
est fausse des le debut du programme : 

#Declaration et initialisation du compteur de boucle 

COMPTEUR : entier 

C0MPTEUR=0 

#Debut du programme 

boucleSi(COMPTEUR>0) 

Ecrire ("Nombre de tours :") 

Ecrire (COMPTEUR) 

C0MPTEUR=C0MPTEUR-1 

finBoucl e 

Ecrire ("Fin du programme") 
#Fin du programme 

Dans ce cas, aucune information n'est affichee, hormis celle qui indique la fin du programme : 
| Fin du programme 



Figure 8-5 

Structure de boucle 
boucleSi( )-finBoucle 




BLOC 1 



evolution 
COMPTEUR 



COMPTEUR=nbreTour 



boucleSi(condition) 



instruction 1 
instruction2 



COMPTEUR=COMPTEUR-1 



finBoucle 
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Structures de boucle avec debutBoucle-boucleSiQ 

Contrairement a la structure presentee ci-dessus, le test boucl eSi ( ) est place apres le bloc de code et 
oblige le programme a executer au moins une fois le corps de boucle, meme si la condition de boucle 
est fausse des le depart (voir figure 8-6). 

Figure 8-6 

Structure de boucle 
debutBoucle-boucleSi( ) 



initilisation 
COMPTEUR 



COMPTEUR=nbreTour 




debutBoucle 



instruction 1 
instruction2 



COMPTEUR=COMPTEUR-1 



boucleSi(condition) 



I 

Dans Fexemple ci-dessous, le programme executera trois fois le corps de boucle : 

#Declaration et initialisation du compteur de boucle 

COMPTEUR : entier 

C0MPTEUR=3 

#Debut du programme 

debutBoucle 

Ecrire ("Nombre de tours :") 

Ecrire (COMPTEUR) 

C0MPTEUR=C0MPTEUR-1 
boucleSi(COMPTEUR>0) 
Ecrire ("Fin du programme") 
#Fin du programme 
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Informations afflchees par le programme : 

Nombre de tours : 3 
Nombre de tours : 2 
Nombre de tours : 1 
Fin du programme 

Dans ce second exemple, le programme execute une fois le corps de boucle bien que la condition de 
boucle soit fausse des le debut du programme : 

#Declaration et initialisation du compteur de boucle 

COMPTEUR : entier 

C0MPTEUR=0 

#Debut du programme 

debutBoucl e 

Ecrire ("Nombre de tours :") 

Ecrire (COMPTEUR) 

C0MPTEUR=C0MPTEUR-1 
boucleSi(COMPTEUR>0) 
Ecrire ("Fin du programme") 
#Fin du programme 

Informations afflchees par le programme : 

Nombre de tours : 0 
| Fin du programme 

Instructions de contrdle de boucle 

Instruction de contrdle avec quitterBoucle 

II est quelquefois necessaire de sortir de la boucle avant que l'expression de boucle ne renvoie une 
valeur fausse. L'instruction de controle quitterBoucle peut etre utilisee pour forcer le programme a 
quitter la boucle (voir figure 8-7). En general, cette instruction est conditionnee par une structure de 
choix. 

Dans l'exemple ci-dessous, le programme sortira completement de la boucle des que la variable 
ARRET sera activee (si elle est egale a vrai) meme si les trois tours de boucle ne sont pas encore 
effectues : 

#Declaration et initialisation du compteur de boucle 

ARRET : booleen 

COMPTEUR : entier 

C0MPTEUR=3 

#Debut du programme 

boucleSi(COMPTEUR>0) 




si (ARRET) 

quitterBoucle 



finSi 

Ecrire ("Nombre de tours :") 
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Ecrire (COMPTEUR) 
C0MPTEUR=C0MPTEUR-1 

FinBoucl e 

Ecrire ("Fin du programme") 
#Fin du programme 

Si la valeur ARRET est activee lors du second tour, les informations affichees par le programme seront 
les suivantes : 

Nombre de tours : 3 
Fin du programme 




i i 



Figure 8-7 

Instruction de controle quitterBoucle 



Instruction de controle avec boucleSuivante 

Une autre instruction de controle de boucle permet au programme de passer directement au tour de 
boucle suivant (voir figure 8-8). Comme pour Finstruction precedente, l'utilisation de boucl eSui vante est 
souvent conditionnee par une structure de choix. 

Dans l'exemple ci-dessous, le programme passe directement a la boucle suivante si la variable 
SUIVANT est activee (si elle est egale a vrai) : 

#Declaration et initialisation du compteur de boucle 
SUIVANT : booleen 
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COMPTEUR : entier 
C0MPTEUR=3 
#Debut du programme 
boucleSi(COMPTEUR>0) 
si(SUIVANT) 

boucleSuivante 

finSi 

Ecrire ("Nombre de tours :") 
Ecrire (COMPTEUR) 
C0MPTEUR=C0MPTEUR-1 

FinBoucl e 

Ecrire ("Fin du programme") 
#Fin du programme 

Si la valeur SUIVANT est activee lors du second tour, le programme affichera les informations ci- 
dessous : 

Nombre de tours : 3 
Nombre de tours : 1 
Fin du programme 



initilisation 
COMPTEUR 




Figure 8-8 

Instruction de contrdle boucleSuivante 



Introduction a la programmation structures 

Chapitre 8 



Concept de la fonction 

Une fonction permet d'utiliser une meme suite d' instructions a plusieurs reprises depuis tout point 
d'un programme. Cela devient tres interessant des que Ton desire faire appel plusieurs fois a un 
meme ensemble d' instructions. La plupart des langages de programmation disposent par defaut de 
nombreuses fonctions integrees qui ne necessitent pas d'etre declarees. Vous pouvez egalement creer 
vos propres fonctions utilisateur. 

La declaration d'une fonction commence par un en-tete qui identifie la fonction (son nom, ses even- 
tuels arguments...). Le corps de la fonction est constitue d'un bloc d' instructions semblable a celui 
qui est utilise dans les structures de choix et de boucle. En debut du bloc, on retrouve une partie 
dediee a la declaration des variables locales. La vie des variables locales d'une fonction est limitee 
aux frontieres de son bloc, ce qui permet d'eviter les conflits entre noms de variables identiques utilises 
dans des fonctions differentes. Le reste du bloc regroupe les instructions de la fonction, eventuel- 
lement cloturees par une instruction de renvoi du resultat au programme appelant. 

Une fonction peut etre generique et se contenter d'executer un meme bloc a un moment donne, mais 
on peut aussi la personnaliser en lui passant des parametres lors de son appel. Ces parametres sont 
ensuite recuperes et peuvent etre exploites comme des variables locales dans le bloc de la fonction. 
Une autre caracteristique des fonctions est qu'elles peuvent renvoyer le resultat final de la fonction au 
programme appelant. Dans ce cas, la valeur retournee se substitue a 1' instruction d' appel, ce qui 
permet de l'affecter a une variable du programme afin de 1' exploiter dans les instructions suivantes 
(voir figure 8-9). 

Dans l'exemple ci-dessous, le programme principal appelle la fonction moyenne( ) a deux reprises en 
lui transmettant des parametres differents. Les resultats obtenus sont ensuite affiches : 

#Declarations des variables et des fonctions 
Fonction : moyenne(X.Y) 
debutFonction 

RES : entier 

RES=(X+Y)/2 

RENVOKRES) 
finFonction 
RESULTAT1 : entier 
RESULTAT2 : entier 
#Declaration des variables 
A : entier 
B : entier 
RES : entier 
#Debut du programme 

Ecrire ("Indiquez la premiere valeur :") 
Lire (A) 

Ecrire ("Indiquez la seconde valeur :") 
Lire (B) 

RESULTATl=moyenne(A,B) 

Ecrire ("La moyenne de vos deux valeurs est :") 
Ecri re(RESULTATl) 

Ecrire ("Indiquez la premiere valeur :") 
Lire (A) 
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Ecrire ("Indiquez la seconde valeur :") 
Lire (B) 

RESULTAT2=moyenne(A,B) 

Ecrire ("La moyenne de vos deux valeurs est :") 
Ecrire(RESULTAT2) 
Ecrire ("Fin du programme") 
#Fin du programme 

Si Ton teste ce programme, les informations ci-dessous seront alors affichees (les valeurs en italiques 
sont des valeurs saisies par Futilisateur et les valeur en gras sont celles qui seront affichees par le 
programme) : 

Indiquez la premiere valeur : 4 
Indiquez la premiere valeur : 2 
La moyenne de vos deux valeurs est : 3 
Indiquez la premiere valeur : 8 
Indiquez la premiere valeur : 6 
La moyenne de vos deux valeurs est : 7 




Figure 8-9 

Illustration du processus d'appel d'une fonction 
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PHP 

et la programmation structuree 



Jusqu'a present, nous avons realise de petits programmes PHP composes d'un enchainement 
lineaire d' instructions, mais, en pratique, les programmes sont rarement constitues d'une simple 
suite d'instructions. Pour creer des programmes avances, PHP met a votre disposition plusieurs 
structures qui permettent de diviser le programme en de multiples sous-programmes (f uncti on( )) 
et de controler son deroulement en utilisant des structures de choix (if, else...) ou de boucle 
(while, for...). 

Portee des variables 

Definition d'un bloc 

Vous pouvez regrouper les instructions a l'aide d' accolades { et } pour constituer des blocs d'instruc- 
tions. Chaque bloc ainsi constitue se comporte comme une instruction. Un ensemble de blocs peut 
etre regroupe au sein d'un autre bloc. La creation d'un bloc isole, comme dans l'exemple ci-dessous, 
n'a pas d' application pratique ; en revanche, les blocs sont frequemment utilises dans la declaration 
de programmes utilisateur et dans les structures de choix et de boucles. 

// Exemple d'un bloc simple 
{ 

$varl="bonjour" ; 
echo $varl; 
} 
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Temps de vie des variables 

Selon le contexte dans lequel elles sont utilisees, les variables ont un temps de vie different : le temps 
de vie d'une variable de fonction est limite a la duree de la fonction, alors que le temps de vie d'une 
variable de programme est limite a la duree d'utilisation de la page dans laquelle elle a pris naissance. 
Dans chaque cas, il est possible de prolonger ce temps de vie (appele aussi « portee »). Si on reprend 
l'exemple de la variable de fonction, sa portee peut etre etendue au programme qui l'appelle en la 
declarant comme variable globale (pour plus d' informations sur la declaration d'une variable globale, 
reportez-vous a la section Fonctions utilisateur, plus loin dans ce chapitre). II est egalement possible 
d'etendre la portee d'une variable de programme, normalement limitee a la page dans laquelle elle a 
pris naissance, aux autres pages grace a differentes techniques. Cette possibilite n'est pas negligea- 
ble, car dans un site interactif, il faut souvent memoriser des informations specifiques a un visiteur 
durant toute la duree de sa visite (la session). De meme, dans un site marchand, il est indispensable 
de memoriser les produits commandes par l'internaute avant de l'aiguiller vers le terminal de paie- 
ment en ligne. Dans un autre contexte, les outils de statistiques peuvent memoriser le parcours de 
chaque internaute arm de definir, apres traitement, les chemins les plus utilises. Enfin, dans un site 
protege, il est difficilement concevable de demander l'identifiant et le mot de passe de l'internaute a 
chaque nouvel ecran. 

Le protocole HTTP ne conservant aucune information sur les echanges realises entre l'internaute et 
le serveur Web, il faut trouver des solutions pour conserver l'etat de certaines variables d'une page a 
l'autre, pendant toute la duree d'une session ou, mieux encore, d'une session a l'autre. Parnii les 
differentes techniques disponibles, certaines etendent la portee de la variable a la page suivante appe- 
lee par l'internaute (formulaires POST/GET ou passage de variables par FURL), d'autres memorisent 
certaines variables pendant toute la duree de la session (variables de session ou cookies temporaires) 
et, enfin, certaines techniques, plus elaborees, enregistrent ces variables d'une session a l'autre, voire 
pour une duree infinie (cookies enregistres sur le disque de l'internaute ou memorisation des infor- 
mations dans une base de donnees cote serveur). Nous vous presentons ci-dessous ces differentes 
techniques. 



Utilisez les tableaux de variables HTTP 

Avec PHP 5 ou une version egale ou superieure a PHP 4.2, les tableaux de variables HTTP sont necessaires pour 
recuperer les valeurs depuis un formulaire. Concretement, vous ne pouvez plus utiliser une simple variable comme 
SnomDeVariable dans les cas enonces precedemment. II faut recourir a $_POST['nomDeVariable'] ou 
$HTTP_POST_VARS['nomDeVariable'], par exemple, pour recuperer une variable issue d'un formulaire para- 
metre avec la methode POST. Cependant, si vous desirez exploiter d'anciens scripts sur un serveur dote d'une 
version recente de PHP, il vous reste toujours la possibilite de modifier le fichier de configuration de PHP php . inl 
en initialisant le parametre register_global avec lavaleur On. 

Depuis la version 4.1 de PHP, les tableaux de variables HTTP sont remplaces par une nouvelle serie de tableaux 
plus simples a ecrire ($_P0ST[], $_GET[] , $_C00KIE[] et $_SESSI0N[]). Cependant, I'ancienne serie (de 
type $HTTP_XXX_VARS[]) est utilisable quelle que soit la version du PHP. 
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Les formulaires 

L' utilisation des formulaires est tres frequente dans les sites Web. II y a differents moyens d'exploiter 
les donnees envoyees lors de la soumission du formulaire par Finternaute, selon ce que vous desirez 
faire avec ces informations et la plate-forme dont vous disposez. Le plus simple consiste a configurer 
l'attribut action de la balise <form> pour rediriger les donnees vers l'e-mail du webmestre 
(exemple : <form action="mailto:info@agencew.com">). Cependant, si votre serveur Web inter- 
prete le PHP, il est plus judicieux de rediriger ces donnees vers un script PHP (exemple : 
<form action="reception.php">), afin de traiter les informations avant de les envoyer sur l'e-mail du 
webmestre, de les memoriser dans une base de donnees ou encore de creer une page dynamique 
exploitant les valeurs ainsi recuperees. 

Dans la balise <f orm>, il faut definir l'attribut methode, arm d'indiquer par quelle technique sont trans- 
mises les donnees. Vous pouvez utiliser deux valeurs : GET ou POST. La methode GET ajoute les noms 
des variables et leur valeur a la suite de FURL (methode de transmission identique a celle du passage 
dans l'URL detaillee ci-dessous), alors que la methode POST demande au navigateur d'empaqueter les 
donnees avant de les envoyer au serveur. Le script designe dans l'attribut action peut recuperer des 
donnees, simplement a l'aide de variables creees automatiquement dans le tableau associatif HTTP 
correspondant (soit $_P0ST[], soit $_GET[] selon la methode employee). Lindice du tableau porte 
dans ce cas le meme nom que celui des objets du formulaire correspondant. Par exemple, vous 
pouvez recuperer la valeur d'un champ texte nomme varl dans la page du formulaire en utilisant la 
variable $_GET['varl'] ou $_P0ST[ ' varl ' ], selon la methode utilisee lors de l'envoi (GET ou POST) 
dans la page cible. 

Voici un exemple d' utilisation de formulaire : 

/* Ci-dessous le formulaire de la page source "formulaire.htm". */ 
<form action="reception.php" methode="POST"> 

<table><tr> 

<td>Nom : </td> 

<td><input type="text" name="varl"X/td> 

</tr> 

<tr> 

<td>Valider : </td> 

<td><input type="Submit" value="Valider"X/td> 
</trX/table> 
</form> 

//ci-dessous le script PHP de la page cible "reception. php" 
<?php 

echo "Bonjour ".$_P0ST['varl"]; 

?> 



A noter 

Selon la configuration de votre serveur, il se peut que des messages d'erreur vous informent que I'une des variables 
utilisees dans la page n'est pas declaree. II suffit dans ce cas d'ajouter un test en haut de la page afin d'initialiser 
la variable si elle n'a pas ete encore declaree. Voici le code du test a ajouter pour I'exemple ci-dessus : 

if( !isset($_POST['varl'])) $_P0ST[ ' varl ' ]="" ; 



P^B Programmation stiuctuiee 

Le passage dans I'URL 

Pour passer des variables dans l'URL, on doit indiquer, a la suite du chemin menant a la page 
demandee, le nom de la variable, suivi de sa valeur (exemple : pagesuivante.php?varl=150). 
Dans la page cible, il est ensuite possible de recuperer la valeur grace a une variable portant le 
meme nom au moyen des tableaux de variables HTTP (exemple : $_GET[ ' varl ' ]). Cependant, cette 
solution est limitee par la longueur de 1'URL (255 caracteres au maximum) et par son manque de 
confidentialite (les variables et les valeurs sont visibles dans l'URL a chaque passage d'une page a 
1' autre). 

En pratique, on peut utiliser cette technique en parametrant un lien hypertexte traditionnel declenche 
par l'internaute (voir le premier exemple ci-dessous), ou encore a partir d'un script PHP en utilisant 
la fonction header( ) (voir le deuxieme exemple ci- dessous). 

L'exemple suivant illustre le passage de parametres par un lien hypertexte : 

<a href=" pages ui vante.php?varl=produi tl">produitl</a> 

Ce second exemple illustre le passage de parametres par un script PHP : 

if ($selection= ="produitl" ) 
header ("Locati on :pagesuivante.php?varl=produitl") ; 

Tableau 9-1. Passage de variables dans l'URL 

Syntaxe 

nom_du_fichier?variablel=valeurl[&variable2=valeur2] 
Exemple : fichier.php?varl=100&var2=bonjour&var3=ok 

Legende : [xxx] : le code xxx est facultatif mais peut etre duplique autant de fois qu'il y a de variables a passer. 

(Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 

Les cookies 

Un cookie est une information envoyee par le serveur sur le poste du client, sur lequel elle est memo- 
risee pendant une duree determinee. Dans certains cas, cette duree excede le temps de la visite de 
l'internaute ; il faut alors enregistrer l'information dans un fichier texte sur le disque dur de l'ordinateur 
client. 



A noter 

Seul le serveur ayant enregistre initialement le cookie sur l'ordinateur client peut y acceder par la suite, ce qui evite 
qu'un autre serveur ne puisse exploiter des donnees qui ne le concernent pas. 



Vous devez imperativement appeler la fonction setcooki e( ) en debut de programme, avant tout affichage 
a l'ecran du navigateur. 
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Tableau 9-2. Fonction setcookieQ 



Syntaxe 


setcooki e( " 


nom_cookie"[ , val ue][ , expi re] [ , path] [, domaine] [ .secure] ) 


Legende : 


[xxx] : le code xxx est facultatif. 

(Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 


nom_cookie 


Le nom du cookie est le seul argument obligatoire. Le fait d'envoyer un cookie avec uniquement son nom 
detruit tout cookie portant ce nom sur le navigateur client. 


val ue 


Valeur memorisee dans le cookie. Ce parametre peut etre une valeur ou une variable. 


expi re 


Precise ladureedeviedu cookie, exprimeeen secondes. En pratique, on utilise la fonction time( ), alaquelle 
on ajoute la duree de validite en secondes (exemple : timet )+3600 correspond a une heure). 


path 


Indique le repertoire dans lequel le cookie est valable. Si on ne precise pas de chemin, le cookie est visible 
partout sur le site. 


domaine 


Indique le domaine pour lequel le cookie est valable. Si on ne definit pas de domaine, c'est celui du serveur 
qui a cree le cookie qui est pris en compte (attention, le domaine doit obligatoirement comporter deux points, 
exemple : .agencew.com). 


secure 


Indique que le cookie doit etre obligatoirement transmis par une connexion securisee (protocole HTTPS) si 
cet argument est fixe a 1 . 



Attention ! 

Vous devez imperativement appeler la fonction setcooki e( ) avant toute interpretation de balise HTML.. 
Les cookies ne sont accessibles qu'apres un nouveau chargement de la page. 

Si vous envoyez un cookie sans aucune option (uniquement avec son nom), il supprime le cookie portant le meme nom sur le 
poste client. 

Exemples : 

SetCooki e( "emai 1 " , "monmai l@aol .com" , timet )+3600) ; 

// Cookie "email" memorisant 1 'e-mail "monmail@aol.com" pendant lh 

$unan=365*24*60*60 ; // Temps en secondes correspondant a un an 

$pwd="1234"; 

SetCooki e( "pass" ,$pwd, timet )+$unan) ; 

// Cookie "pass" memorisant la valeur de la variable $pwd pendant 1 an 
SetCooki e( "admin" , $memo, timet )+3600, " / p r i ve/" , " .agencew.com" , 1) ; 

// Cookie "admin" memorisant la valeur de la variable $memo pendant 1 heure et uniquement dans le 
repertoire "prive" pour 1 'usage exclusif du site "agencew.com" en mode HTTPS 
SetCooki e( "badcooke" ) ; 

// Dans ce cas, le cookie badcooke est supprime. 
Recuperer un cookie : 

Les valeurs des cookies sont automatiquement stockees dans le tableau $_COOKIE (exemple: $_COOKIE["email "]) ou 
$HTTP_COOKIE_VARS[ ] pour PHP anterieur a 4.1 . 

Voici un exemple d' utilisation de cookie : 
<?php 

// Cookie comptabi 1 i sant le nombre de passages de l'internaute sur la page du site 

II Initialisation des variables si non declarees 

if(!isset($_COOKIE['cookiel'])) $„COOKIE['cookiel ']=""; 

// Code du cookie integre dans le code de la page Web 
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++$_C00KIE[ 'cookiel' ] ; // Incrementation a chaque affichage 
//print_r($_C00KIE) ; // A utiliser pour les tests 
setcookie("cookiel",$_C00KIE['cookiel'],time()+3600); 
// Appel de la fonction "SetCookiet )" 

echo $_C00KIE['cookiel']; // Affiche la nouvelle valeur a 1'ecran 

?> 

L'exemple ci-dessus memorise dans un cookie une seule variable. Si vous desirez memoriser 
plusieurs variables dans le meme cookie, il faut gerer le cookie comme un tableau (et ajouter des 
crochets apres son nom). L'exemple ci-dessous, utilise pour le traitement des commandes d'un 
caddie, enregistre les differents produits dans un cookie : 

<?php 

// Declaration des variables 

if( !isset($_COOKIE['cpt'])) $_C00KIE[ ' cpt ' ]="" ; 
if ( !isset($_GET['produit'])) $_GET['produit , ]=""; 
el se { 

// Code du cookie integre dans le code de la page Web 

++$_C00KIE[ 'cpt' ] ; // Incrementation a chaque affichage 

setcookieCcpt",$_C00KIE['cpt'],time()+3600); // Appel de la fonction "SetCookie( )" 
// Le compteur "cpt" est repris en indice dans le tableau du second cookie 

$cpt=$_C00KIE[ 'cpt' ] ; // Recuperation du compteur 

setcookie("caddie[$cpt]",$_GET['produit'],time()+3600); 

print_r($_COOKIE['caddie']); // Affichage du caddie 

} 

?> 

II est egalement possible d' utiliser un cookie pour controler Faeces a une page pendant le temps 
d'une session, sans avoir a ressaisir le mot de passe. Pour qu'il soit valide tout le temps de la session, 
il suffit de ne pas preciser 1' argument expire. De plus, ann que le cookie soit utilisable en tant que 
variable, il faut integrer une fonction header ( ) ann de recharger la page des que le cookie est enregis- 
tre dans la session. Le programme ci-dessous comprend le formulaire HTML affiche lors du premier 
appel de la page et le script de gestion du cookie. 

Voici un exemple de protection d'une simple page nommee pagePrivee.php avec un cookie : 
<?php 

// Declaration des variables 

if( !isset($_POST['pwd'])) $_P0ST[ ' pwd' ]="" ; 

if( !isset($_COOKIE['cookiepass'])) $_CO0KIE[ ' cookiepass ' ]="" ; 

/7 

if($_POST['pwd']=="eyrolles") { 

setcookie( "cookiepass" ,$_P0ST[ 'pwd ' ] ) ; 
/* Le cookie est enregistre sous le nom "cookiepass". */ 
header( "Location: ".$HTTP_SERVER_VARS['PHP_SELF']) : 

/* La page est rechargee afin que le cookie soit exploitable sous le nom de 
variable Scookiepass" . */ 

} 
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if($_COOKIE['cookiepass']=="eyrolles") 
{ 

// print_r($_C00KIE) ; a utiliser pour les tests 
?> 

Votre mot de passe est correct 
Inserez ici la zone protegee 
<?php 
} 

el se 
{ 

?> 

<form method="post" action=" pagePrivee.php" > 
<table><tr> 

<td><input type="password" name="pwd"X/td> 
<td><input type="Submit" val ue="Entrer"X/td> 
</trX/table> 

</form> 

<?php 

} 

?> 



Les sessions 

Depuis PHP 4, la gestion des sessions est plus facile. Des qu'une nouvelle session est demandee, un 
identifiant de session est automatiquement cree, auquel on associe les differentes variables memori- 
sees durant la session. Concretement, un fichier temporaire du meme nom que F identifiant de session 
est cree sur le serveur Web (dans le repertoire /tmp sur les serveurs UNIX). Ainsi, lorsqu'une variable 
doit etre actualisee ou ajoutee, on ecrit dans le fichier de session. De meme, pour recuperer la valeur 
d'une variable de session, on lit dans ce fichier. L'identifiant de la session (PHPSESSID) est envoye par 
le serveur Web via un cookie au poste client, afin de le memoriser pendant la duree de sa visite. 
Toutefois, dans le cas oil le client refuse les cookies, PHP transmet automatiquement par FURL 
(exemple : mapage.php?PHPSESSID=xxxxx) F identifiant de la session ouverte, afin d' assurer sa memori- 
sation pendant la visite de Finternaute. 



Tableau 9-3. Fonctions de gestion des sessions 



Fonction 


Definition 


session. 


startt ) 


Initialise la session. Si la session n'existe pas encore, un identifiant de 
session est cree puis transmis dans un cookie. Si la session existe deja, 
la fonction actualise toutes les variables memorisees dans la session 
existante. 

Attention ! Vous devez imperativement appeler cette fonction avant toute 
interpretation de balise HTML. 


session. 


destroyt ) 


Detruit toutes les donnees associees a une session. 


session. 


id() 


Renvoie l'identifiant de la session en cours. 
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Tableau 9-3. Fonctions de gestion des sessions (suite) 



session_regi stert "varl" ) 
Attention ! Pour les versions de PHP superieu- 
res a 4.1 , il conviendra d'utiliser les tableaux de 
variables HTTP soit : 

$HTTP_SESSION_VARS['varl']="valeur" 
ou $_SESSION['varl']="valeur" 

s ess ion_un register^ "varl" ) 
Attention ! Pour les versions de PHP superieu- 
res a 4.1 , il faut utiliser les tableaux de variables 
HTTP associes a la fonction unset() pour sup- 
primer une variable de session. 
Exemple : 

unset($_SESSION["var']); 
sessi on_i s_regi stered( "varl" ) 



Memorise la variable $varl dans la session en cours. 
Remarque : si vous utilisez la fonction session_register ("varl") , 
vous devrez affecter lavaleur dans une instruction differente (par exemple : 
$varl="valeur" ;). 

En revanche, si vous utilisez le tableau HTTP, I'affectation et la memorisation 
dans la session seront realisees avec la meme instruction (par exemple : 
$_SESSION[ 'varl' ] = "valeur" ;). 

Supprime la variable $varl de la session en cours. 



Renvoie dans la session en cours la valeur booleenne true si la variable 
$varl est memorisee et lavaleur FALSE si elle ne Test pas. 



Voici un exemple d'enregistrement et d' utilisation d'une variable de session : 

/* A placer en haut d'une premiere page : enregistrement de la variable "$varl" dans la 

*»session en cours */ 
session_start( ) ; 

$_SESSION['varl'] = "bonjour"; 
/* A placer en haut d'une autre page : recuperation de la variable "$varl" depuis la session 

*»en cours */ 
session_start( ) ; 

echo $_SESSION['varl']; // Affiche la valeur recuperee 

Voici maintenant un exemple de protection d'une simple page pagePrivee.php avec une session : 

<?php 

session_start (); 

// Initialisation des variables 

if( !isset($_SESSION['pass'])) $_SESSI0N[' pass ']=""; 
i f ( ! i sset ( $_P0ST[ ' pwd ' ] ) ) $_P0ST[ ' pwd ' ] = " " ; 

// Test la variable de formulaire 

if ($_POST['pwd']=="eyrolles") 

// Enregistre le pwd dans la session 

$_SESSI0N[ 'pass ']=$_P0ST[ 'pwd']; 

// Test la variable de session 

if ($_SESSI0N[ " pass ']=="eyrol les") 
f 

// echo print_r($_SESSION) ; // A utiliser pour les tests 
?> 

Votre mot de passe est correct 

Vous pouvez mettre $$$indiquer ?$$$ici la zone protegee 

<?php 

} 

el se 
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{ 

?> 

<form method="post" action=" pagePrivee.php" > 
<table><tr> 

<td><input type="password" name="pwd"X/td> 
<td><input type="Submit" val ue="Entrer"X/td> 
</trX/table> 

</form> 

<?php 

} 

?> 



Fonctions utilisateur 

Dans le chapitre 6, nous avons deja presente les nombreuses fonctions integrees par defaut dans PHP. 
Cependant, il est souvent necessaire en pratique de creer des fonctions utilisateurs adaptees aux 
besoins du programme. 



Gestion des fonctions utilisateur 

Declaration et utilisation des fonctions 

Une fonction permet d'exploiter une meme partie de code a plusieurs reprises dans un programme, ce 
qui est tres interessant pour les routines standards souvent utilisees en programmation (affichage 
d'une valeur, calculs mathematiques courants, conversions...). PHP propose de nombreuses fonc- 
tions integrees en standard, que nous etudierons dans la section suivante (echo( ), par exemple). Vous 
pouvez egalement realiser vos propres fonctions en les declarant a l'aide du mot-cle functionO. 
Dans une fonction, il est possible d'exploiter des variables sans risque de conflit avec celles du 
programme principal, car elles n'ont qu'une portee locale. La declaration d'une fonction comporte 
une tete et un corps. Le mot-cle function est place dans la tete de la fonction, suivi du nom de celle- 
ci et, entre parentheses, de la liste des arguments attendus separes par une virgule (lorsque la fonction 
ne comporte pas d' argument, les parentheses sont vides). La tete de la fonction est suivie du corps 
encadre par des accolades (comme pour un bloc). Les fonctions ont generalement une valeur de 
retour, designee par le mot-cle return, suivi du resultat retourne dans le programme. 



Important 

La valeur retournee avec return (exemple : return $res) se substitue a I'appel de la fonction (exemple : 
moyenne(4,6)) dans le programme principal. II est alors possible d'affecter ce resultat a une autre variable pour 
I'exploiter ulterieurement. 

Par exemple, si la fonction est appelee de cette maniere : 

$moncalcul=moyenne(4,6) ; 
et si le resultat retourne est $res (return $res), I'appel de la fonction est alors equivalent a I'affectation 
suivante : 

$moCal cul =$res ; 



Programmation structuree 

Partie III 



Tableau 9-4. Fonctions utilisateur 



Syntaxe de la declaration d'une fonctlon 

function nom_de_fonction (argl , arg2...) 
( 

instruction].; 
instruction2; 

[return $varO;] 
} 

Syntaxe de I'utlllsatlon d'une fonctlon 

nom_de_fonction (argl ,arg2...) ; 

Remarques Le nom de la fonction ne doit comporter ni espace ni point. 

Les parentheses permettent de passer des arguments separes par des virgules . 

Les arguments peuvent etre des variables ou des constantes. 

La duree de vie d'une variable de fonction est limitee au temps d'execution de la fonction. 

return permet de retourner une variable resultat $varO dans le programme, mais sa presence n'est pas 

obligatoire. 

[xxx] : le code xxx est facultatif. 

(Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 
Exemple : creation d'une fonction moyenne () pour le calcul de la moyenne de deux valeurs. 

// Declaration de la fonction 

function moyenne ($a,$b) //tete de la declaration 
( // Debut du corps 

$res=($a+$b)/2; // Instructions de la fonction 

return $res; // Information retournee au programme 

} //fin du corps 

// Utilisation de la fonction dans le programme 

$moncalcul=moyenne(4,6) ; // Appel de la fonction 

echo "la moyenne de 4 et de 6 est egale a $moncalcul"; 

Utilisation avancee des fonctions 

Retour de plusieurs resultats 

Avec le mot-cle return, il est possible de renvoyer une variable resultat dans le programme principal. 
Cependant, dans certaines applications, il est utile de recuperer plusieurs valeurs de resultat. Dans ce 
cas, la solution consiste a utiliser un tableau en guise de variable retournee par return ( ), comme le 
montre F exemple ci-dessous : 

// Declaration de la fonction 

function calcul ($a,$b,$c) 
f 

$resl=($a+$b); 
$res2=($a+$c) ; 
$res=array ($resl,$res2); 
// Le resultat est un tableau de valeurs 
return $res; 
} 
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II Utilisation de la fonction dans le programme -- 
$moncalcul=cal cul (4,6,5) ; 
echo Smoncal cul [0] ; 
echo Smoncal cul [1] ; 

/* Appel de la fonction et recuperation du resultat dans le tableau $moncalcul[] ; les deux 
*»resultats du calcul peuvent ainsi etre exploites dans le programme principal. */ 

Arguments facultatifs 

Les arguments d'une fonction peuvent devenir facultatifs s'ils sont parametres avec leur valeur par 
defaut dans la declaration. La valeur par defaut d'un argument doit obligatoirement etre une constante. 
De meme, il convient de placer les arguments dotes d'une valeur par defaut a la fin de F enumeration 
des arguments dans la parenthese. Lexemple ci-dessous reprend la meme fonction moyenneO que 
precedemment, mais avec la possibilite de passer un troisieme argument optionnel : si ce troisieme 
argument n'est pas passe dans 1' appel de la fonction, il prend sa valeur par defaut, soit la valeur 
euros : 

// Declaration de la fonction 

function moyenne($a,$b,$c=" euros") 
// $c est initialised avec "euros" par defaut 
{ 

$res=($a+$b)/2; 
$res.=$c; 

// Ajoute 1 'unite au resultat exemple : 5 euros 
return $res; 
} 

// Utilisation de la fonction dans le programme 
$moncalcul=moyenne(4,6) ; 

/* Appel de la fonction avec deux arguments uniquement */ 
echo "la moyenne de 4 et de 6 est egale a $moncalcul"; 
/* Dans ce cas, la ligne ci-dessus affiche : 
"la moyenne de 4 et de 6 est egale a 5 euros" */ 

Voici maintenant un exemple avec passage de trois parametres et trois arguments : 

// Declaration de la fonction 

function moyenne ($a,$b,$c="euros") 

//$c est initialised a "euros" par defaut 

{ 

$res=($a+$b)/2; 
$res.=$c; 

// Ajoute 1 'unite au resultat exemple : 5 dollars 
return $res; 
} 

// Utilisation de la fonction dans le programme 

$moncalcul=moyenne(4,6, "dol 1 ars" ) ; 

// Appel de la fonction avec trois arguments 

echo "la moyenne de 4 et de 6 est egale a $moncalcul"; 

/* Dans ce cas, la ligne ci-dessus affiche : 

"la moyenne de 4 et de 6 est egale a 5 dollars"*/ 
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Variables globales 

Par defaut, les variables definies dans une fonction ont une portee limitee a celle-ci (variables loca- 
les). Ainsi, dans l'exemple precedent, vous pouvez tres bien exploiter la variable $res a la fois dans la 
fonction et dans le programme principal sans risque de conflit. De meme, il n'est pas possible de 
recuperer la valeur qui a ete affectee a cette variable dans le programme principal sans la retourner 
avec le mot-cle return. II existe toutefois une solution pour augmenter la portee d'une variable afin 
qu'elle puisse etre exploitee dans la fonction et dans le programme principal (variable globale) : il 
faut la declarer dans la fonction en utilisant le prefixe gl obal , comme le montre l'exemple ci-dessous 
(selon la version de votre PHP, la syntaxe pour la declaration et F utilisation des variables globales 
peut varier mais le principe reste le meme) : 

// Declaration de la fonction 

function moyenne($a,$b) 
f 

global $res; // La variable $res est maintenant de type global 
$res=($a+$b)/2; 

} 

// Utilisation de la fonction dans le programme -- 
moyenne(4,6) ; 

/* La variable $res peut maintenant Stre exploitee dans le programme principal */ 
echo $res; // Affiche la valeur 5 

Utilisation de fonctions externes 

Inclusion de fichiers avec require() 

Pour eviter de declarer dans chaque programme vos fonctions utilisateur, vous pouvez les regrouper 
dans un meme fichier, mesfonctions.php par exemple, insere dans le script grace a la commande 
requi re( ). Si le fichier appele ne se trouve pas dans le meme repertoire que le fichier appelant, il faut 
preciser le chemin pour acceder au fichier bibliotheque (exemple : requi re ( "bibl iotheques\mesfonc- 
tions.php")). En outre, la variante requi re_once( ) evite d'inclure plusieurs fois le fichier appele. 

Voici un exemple d'inclusion de fichier avec requi re( ) : 

// 

// Contenu du fichier "mesfonctions.php" 

<? 

function moyenne ($a,$b ) 
f 

$res=($a+$b)/2; 
return $res; 

} 

?> 
// 

/* Contenu d'un autre fichier utilisant les fonctions du fichier "mesfonctions.php" */ 
<?php 
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requi re( "mesfonctions . php" ) ; 
$moncalcul=moyenne(4,6) ; 
// Appel de la fonction 

echo "la moyenne de 4 et de 6 est $moncalcul "; 

?> 

Inclusion de fichiers avec include() 

La commande requi re( ) est bien adaptee a l'inclusion d'un fichier regroupant des fonctions, car il ne 
doit etre appele qu'une seule fois au debut de la page. Cependant, cette commande n'est pas une 
fonction et reste independante des structures de programme. Vous ne pouvez done pas integrer 
une commande requi re( ) dans une boucle (car elle n'est executee qu'une seule fois, quel que soit le 
nombre de boucles) ou dans une structure de choix (car elle est toujours executee, que la condition de 
choix soit vraie ou fausse). Si vous desirez ajouter un fichier gere par une structure de programme, il 
faut utiliser la fonction include( ). Cette fonction est bien adaptee lorsque vous voulez inclure des 
blocs de code plusieurs fois dans la meme page ou les conditionner par une instruction de choix. 
Comme pour la fonction requi re( ), la variante i ncl ude_once( ) evite d'inclure plusieurs fois le fichier 
appele. 

Voici un exemple illustrant la difference entre i ncl ude( ) et requi re( ) : 

if ($condition=="oui") 

{includet 'fichier.php' )} 
/* Dans ce cas, si le test est positif, le fichier est inclus ; dans le cas contraire, 
*»il n'est pas inclus. */ 

// 

if ($condition=="oui") 

(requi ret 'fichier.php' )} 
/* Dans ce deuxieme cas, le fichier est inclus quel que soit le resultat du test, car il est 
Hindus avant 1 'interpretation du script. */ 

Structures de programme 

Les structures des programmes permettent de creer des scripts qui reagissent differemment selon des 
evenements (structures de choix) ou executent d'une maniere repetitive le meme bloc destructions 
(structure de boucle). 

Structures de choix 

Structures de choix avec if 

Les structures de choix sont utilisees pour traiter les alternatives logiques au cours de 1' execution du 
script, afin d'orienter le deroulement du programme en fonction du resultat de F alternative. Elles 
comprennent en general une expression de condition. Les expressions de condition sont constitutes 
de variables ou de constantes reliees par des operateurs logiques. Si F expression de condition entre 
parentheses est vraie, F instruction qui suit est executee, sinon il ne se passe rien et le programme 
continue de se derouler apres le bloc du i f . 
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Tableau 9-5. Instruction conditionnelle if 

Syntaxe 

if (expression_de_condition) 
{ 

instructionl ; 
instruction2; 

\] 

Forme simplifiee (s'il n'y a qu'une seule instruction a traiter) : i f (expression_de_condi tion) instructionl ; 

Voici un exemple : 

if ($varl>4) 

echo "la valeur est superieure a 4"; 

/* Ci-dessus un exemple de structure "if" avec une seule instruction */ 
// 

if ($varl>4) 

{//debut du bloc if 

echo "la valeur est superieure a 4"; 

echo "<br> el 1 e est exactement egale a $varl"; 

}// Fin du bloc if 
// Ci-dessus un exemple de structure "if" avec un bloc d'instructions 

Structures de choix avec if et else 

La structure de choix utilisant 1' instruction i f ne traite que les structures de programme ou la condi- 
tion est vraie ; dans le cas contraire, aucune instruction n'est executee. Avec Finstruction el se, vous 
pouvez definir les instructions a executer dans le cas ou la condition testee serait fausse. Ces instructions 
sont regroupees dans un autre bloc qui suit l'instruction el se. 

Tableau 9-6. Instructions conditionnelles if et else 

Syntaxe 

if (expression_de_condition) 

( 

instructi onl ; 
instruction2; 

} 

el se 

{ 

instruction3; 
instruction4; 

I l 
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Voici un exemple : 

if ($varl>4) 
{ 

echo "la valeur est superieure a 4"; 

echo "<br> elle est exactement egale a $varl "; 

} 

el se 

{// Debut du bloc else 

echo "la valeur est inferieure ou egale a 4"; 
echo "<br> elle est exactement egale a $varl"; 
}// Fin du bloc else 
// Ci-dessus un exemple de structure "if" avec "else" 

Structures de choix avec if, elseif et else 

En pratique, lors d'un choix, plusieurs conditions doivent etre testees. Dans ce cas, il faut utiliser 
l'instruction elseif, qui est en quelque sorte une combinaison du else et du if suivant ; elle se 
place a la suite d'une instruction i f pour introduire le bloc a executer au cas ou sa condition serait 
fausse (comme le else) et introduit une nouvelle condition (comme le if). Vous pouvez ainsi 
creer autant de conditions imbriquees que vous le souhaitez selon le nombre d' instructions elseif 
utilisees. 

Tableau 9-7. Instructions conditionnelles if, elseifet else 

Syntaxe 

if (expression_de_condition) 
{ 

instructionl ; 
instruction?; 

} 

elseif (expression_de_condition) 

{ 

instruction3; 
instruction4; 

) 

el se 
{ 

instruction5; 
instruction6; 



1 
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Voici deux exemples de cette structure : 

II Exemple 1 

if ($varl>4) 
f 

echo "la valeur est superieure a 4"; 

echo "<br> el 1 e est exactement egale a $varl"; 

} 

elseif ($varl>2) 

{// Debut du bloc elseif 

echo "la valeur est superieure a 2 mais inferieure ou egale a 4"; 
echo "<br> el 1 e est exactement egale a $varl"; 
}// Fin du bloc elseif 
el se 
f 

echo "la valeur est inferieure ou egale a 2"; 
echo "<br> el 1 e est exactement egale a $varl"; 
} 

/* Ci-dessus un exemple de structure "if" avec "else" et une seule instruction 
"elseif" */ 



II Exemple 

2if ($varl>4) 
f 

echo "la valeur est superieure a 4"; 

echo "<br> el 1 e est exactement egale a $varl"; 

} 

elseif ($varl>2) 

{// Debut du bloc 1 elseif 

echo "la valeur est superieure a 2 mais inferieure ou egale a 4"; 
echo "<br> el 1 e est exactement egale a $varl"; 
}// Fin du bloc 1 elseif 
elseif ($varl>l) 

{// Debut du bloc 2 elseif 

echo "la valeur est superieure a 1 mais inferieure ou egale a 2"; 
echo "<br> el 1 e est exactement egale a $varl"; 
}// Fin du bloc 2 elseif 
el se 
f 

echo "la valeur est inferieure ou egale a 1"; 
echo "<br> el 1 e est exactement egale a $varl"; 
} 

/* Ci-dessus un exemple de structure "if" avec "else" et deux instructions 
"elseif" */ 
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Structures de choix avec switch ... case 

Vous pouvez remplacer une structure avec plusieurs el sei f par une structure exploitant F instruction 
switch. Celle-ci permet de tester l'egalite d'une valeur passee en parametre (val eur_testee) avec une 
serie de valeurs possibles (valeurl, valeur2...). Si l'une des valeurs correspond a la valeur testee, le 
bloc d' instructions coiTespondant est execute. L' execution des instructions doit se terminer par une 
instruction break, arm que le programme puisse sortir de la structure de choix. On peut ajouter 
une branche default a la fin d'un bloc, afin de traiter tous les cas non prevus dans la structure. 

Tableau 9-8. Instruction switch ... case 

Syntaxe 

switch (valeur_testee) 

{ 

case valeurl: 

instruction!; 

break; 
case valeur2: 

instruction2; 

break; 
case valeur3: 

instruction3; 

break; 




default: 
instructionD; 

} 



Voici un exemple de cette structure : 

$varl="fr"; // Cette variable memorise la langue choisie par 1'internaute 

switch($varl) 

{ 

case "fr": 

echo "Bonjour" ; 

break; 

case "en": 

echo "Hello"; 

break; 

case "es": 

echo "Hola"; 

break; 

case "de": 

echo "Guten Tag"; 

break; 

} 

// Pour dire "bonjour" dans la langue de 1'internaute 
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Structures de boucle 

Structures de boucle avec while 

Lorsqu'un ensemble d' instructions doit etre execute plusieurs fois en fonction d'une condition, utili- 
sez les structures de boucle. En PHP, la structure la plus simple est realisee a l'aide de l'instruction 
while. Le bloc destructions est execute et repete tant que l'expression de condition retourne TRUE 
(vraD. Lorsque la condition est ou devient fausse (FALSE), le programme sort de la boucle pour 
executer les instructions qui se trouvent apres la fin du bloc. Dans cette structure, il est frequent 
d'utiliser une variable dediee pour le compteur de boucle (exemple : $i). Vous devez initialiser cette 
variable avant la boucle. Elle est ensuite testee dans l'expression de condition, puis incrementee (ou 
decrementee selon les cas) dans le corps de boucle. La valeur de l'expression de condition etant 
evaluee avant chaque debut de boucle, les instructions du bloc peuvent ne jamais etre executees si la 
condition est evaluee a FALSE des le debut. Pour faire evoluer le compteur de boucle, on utilise gene- 
ralement un operateur d' incrementation ou de decrementation ($i++ ou $i --). Choisissez le bon type 
d'operateur, en fonction de la valeur de 1' initialisation du compteur et de l'expression de condition 
choisie, sinon vous risquez d'obtenir une boucle infinie. 

Tableau 9-9. Instruction de boucle while 

Syntaxe 

while (expression_de_condition) 
{ 

instruction!.; 
instruction?; 

1 

Voici deux exemples de boucle whi 1 e : 

// Exemple 1 

$i=5; // Initialisation du compteur de boucle a 5 
while($i>0) 
f 

echo "Encore $i tour(s) a faire <br>"; 

$i--; // Decrementation du compteur de boucle 

} 

echo "Voila, c'est enfin termine"; 

/* Ci-dessus un exemple qui affiche cinq fois le meme texte (tant que $i est superieur a 0) 
avant d'afficher le texte final. */ 



// Exemple 2 

$i=0; // Initialisation du compteur de boucle 
while($i>0) 
f 

echo "Encore $i tour(s) a faire <br>"; 

$i--; // Decrementation du compteur de boucle 

} 
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echo "Voila, c'est enfin termine"; 

// Ci-dessus un exemple qui n'affiche pas le texte du corps de boucle car 1 'expression 
de condition est fausse des le debut. 

Structures de boucle avec do ... while 

La structure do ... whi 1 e est semblable a la precedente, mais Fexpression de condition est evaluee 
apres la premiere execution du bloc (le corps de boucle) : celui-ci est done toujours execute au moins 
une fois, meme si Fexpression de condition est fausse des le debut. 

Tableau 9-10. Instruction de boucle do ... while 

Syntaxe 

do 
{ 

instructionl ; 
instruction2; 
} 

while (expression_de_condition) ; 



Voici deux exemples de boucle do ... whi 1 e : 

// Exemple 1 

$i=5; // Initialisation du compteur de boucle 
do 

{ 

echo "Ce texte est affiche au moins une fois <br>"; 
$i--; // Decrementation du compteur de boucle 
} 

while($i>0); 
echo "Fin"; 

/* Ci-dessus un exemple qui affiche cinq fois le meme texte (tant que $i est superieur a 0) 
Savant d'afficher le texte final. */ 



II Exemple 2 

$i=0; // Initialisation du compteur de boucle 
do 

{ 

echo "Ce texte est affiche au moins une fois <br>"; 
$i--; // Decrementation du compteur de boucle 
} 

while($i>0); 
echo "Fin"; 

/* Ci-dessus un exemple qui affiche le texte une seule fois car 1 'expression de condition est 
^•fausse des le premier tour. */ 
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Structures de boucle avec for 

L'instruction for est une troisieme solution pour traiter les boucles. Sa syntaxe est cependant radica- 
lement differente de celle des deux structures precedentes, car les parentheses de l'instruction 
contiennent trois expressions differentes, separees par des points-virgules. Cette syntaxe tres 
compacte est particulierement appreciable quant a la lisibilite du code. 

Tableau 9-11. Instruction de boucle for 

Syntaxe 

for (expressionl[ ,...] ;expression2[ ,_.] ;expression3[ ,...]) 
{ 

instruction].; 
instruction?; 

} 

Legende expressionl : expression evaluee en debut de boucle. Frequemment utilisee pour initialiser lecompteur de boucle 
a I'aide de I'operateur d'affectation (exemple :« $i = 5 »). 

expression? : expression evaluee au debut de chaque passage de boucle. Si le resultat de revaluation est TRUE 
(vrai), le bloc destructions de la boucle est de nouveau execute. Dans le cas contraire, le programme sort de la 
boucle pour executer les instructions qui suivent le bloc. Cette expression est frequemment utilisee pour tester le 
compteur de boucle a I'aide d'un operateur de comparaison (exemple : $i > 0). 

expressi on3 : expression evaluee a la fin de chaque boucle. Frequemment utilisee pour incrementer ou decrementer 
le compteur de boucle a I'aide d'un operateur d'auto-incrementation ou de decrementation (exemple : $i — ). 
A noter : pour chaque zone (delimitee par un point-virgule), il est possible d'executer plusieurs expressions, qui 
doivent etre separees par de simples virgules. Cela permet notamment de gerer plusieurs variables de compteur 
(exemple : for ($i=5, $x=l; $i>0; $i — , $x++) ) . 
[xxx] : le code xxx est facultatif. 

(Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 



Voici un exemple de bloc for : 

for ($i=5;$i>0;$i--) 
f 

echo "Encore $i tour(s) a faire <br>"; 
} 

echo "Voila, c'est enfin termine"; 

// Ci-dessus un exemple qui realise la meme boucle que celle donnee en exemple pour 
**1' instruction "while". 

Structures de boucle avec foreach 

La boucle foreach est dediee a la manipulation des tableaux de variables. Elle permet en effet de lire 
rapidement le contenu d'un tableau sans avoir a ecrire beaucoup de code. Vous avez le choix entre 
deux syntaxes selon le type de tableau (indice ou associatif). Le principe de cette instruction est 
semblable a celui d'une boucle pour laquelle un pointeur interne au tableau est place sur le premier 
element du tableau (0 pour les tableaux indices et premiere cle pour les tableaux associatifs). 
A chaque tour de boucle, la variable $var (voir tableau ci-dessous) contient la valeur de l'element 
pointe : vous pouvez ainsi 1' exploiter dans les instructions du corps de la boucle. A la fin de chaque 
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boucle, le pointeur se deplace sur F element suivant dans le tableau et ainsi de suite jusqu'a la fin du 
tableau. 



A noter 

Dans la syntaxe du tableau associatif, il est egalement possible d'exploiter la cle de chaque element ($cl e) dans 
les instructions du corps de la boucle. 



Tableau 9-12. Instruction de boucle foreach 



Syntaxe pour tableau indice 


foreach($tableau as $var) 
{ 




instruction utilisant $var; 

} 




Syntaxe pour tableau associatif 


foreach($tableau as $cle=>$var) 
{ 




instruction utilisant $cle et $var; 

} 

I 





Void deux exemples d'application de l'instruction foreach : 

// Exemple 1 

$agence=array( "Pari s" , "Lille" , "Marseil 1 e") ; 
foreach ($agence as $ville) 
{ 

echo "Vi 1 1 e:$vil 1 e <br>" ; 
} 

/* Ci-dessus un exemple qui affiche toutes les villes des agences contenues dans le tableau 

^♦indice $agence. */ 

// Exemple 2 

$agence=array( "cent re"=>" Paris" , "nord"=>"Li lie", "sud"=>"Marsei lie"); 
foreach (Sagence as $cle=>$ville) 
{ 

echo "L'agence du secteur $cle se trouve a $ville <br>"; 
} 

/* Ci-dessus un exemple qui affiche tous les secteurs et les villes correspondantes 
des agences contenues dans le tableau associatif Sagence. */ 

Instructions de controle 

Instruction de controle avec break 

Dans certaines applications, il peut s'averer necessaire de sortir de la boucle avant que l'expression 
de condition ne l'impose (c'est valable pour toutes les boucles : while, do ... while, for, switch ... case 
et foreach). L'instruction break permet de quitter la boucle pour que le programme passe a F execution 
des instructions qui se trouvent apres celle-ci. Si plusieurs boucles sont imbriquees, precisez combien 
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de boucles doivent etre stoppees avec 1' argument n de 1' instruction : break n. L' execution du 
programme passe alors directement a la boucle de niveau superieur, si elle existe (par defaut, cet 
argument est egal a 1). 

A noter 

Cette instruction est obligatoire dans les structures switch ... case afin d'eviter d'executer les instructions qui 
suivent la branche du case selectionne. 



Tableau 9-13. Instruction de controle de boucle break 



Syntaxe 

break [n] 
Legende : 



n : nombre de boucles imbriquees qui sont interrompues. 
Par defaut, n est egal a 1. 
[xxx] : le code xxx est facultatif. 

(Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 



Voici un exemple d' application de Finstruction break : 

$i=5; // Initialisation du compteur de boucle 
while($i>0) 
{ 

if ($commande[$i]="arret") 

{break;} // Arrete la boucle si cette variable est egale a "arret" 
echo "Encore $i tour(s) a faire <br>"; 
$i--; // Decrementation du compteur de boucle 
} 

echo "Voila, c'est enfin termine"; 

/* Ci-dessus un exemple qui reprend le script de la premiere boucle "while", dans lequel on 
*»a ajoute une instruction "break" conditionnee par la variable "$commande". Si 1 'expression 
*»de condition renvoie "TRUE", le programme sort prematurement de la boucle et le message de 
*fin s'affiche. */ 

Instruction de controle avec continue 

L'instruction continue est egalement une instruction de controle de boucle. Contrairement a Faction 
break, elle permet de passer au passage de boucle suivant. De meme que pour break, on peut lui 
preciser, par le biais d'un argument optionnel, le nombre de passages de boucle qu'on desire court- 
circuiter. 



Tableau 9-14. Instruction de controle de boucle continue 



Syntaxe 




continue [n] 

n : nombre de passages de boucle ignores, 
[xxx] : le code xxx est facultatif. 

(Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 



Legende : 
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Void un exemple d' application de l'instmction continue : 

for($i=5; $i>0; ++$i) 
{ 

if (■ ($1X2)) 

{continue;} // Court-ci rcuite l'affichage des tours impairs 
echo "Encore $i tour(s) a faire <br>"; 
} 

echo "Voila, c'est enfin termine"; 

/* Ci-dessus un exemple dans lequel on a ajoute une instruction "continue", executee pour 
*»tous les tours impairs (grace a 1 'utilisation de 1'operateur modulo dans 1 'expression de 
^•condition ! ($1X2) ) . Au final, l'affichage du message de boucle est realise uniquement sur 
*»les tours pairs. */ 

Redirection interpage 

Nous venons d'etudier differentes structures qui permettent de gerer le cheminement du programme 
au sein d'une meme page. Cependant, il faut frequemment rediriger le programme automatiquement 
vers une autre page du site. Cette redirection peut etre le resultat d'un test de condition (revoir les 
instructions de choix if, else, elseif et switch) ou bien se situer a la fin d'un script PHP (par 
exemple : apres un script d'ajout d'un nouvel enregistrement, pour rediriger l'intemaute vers une 
page affichant la liste actualisee de tous les enregistrements presents dans la base). Plusieurs solu- 
tions utilisant des langages differents (PHP, JavaScript ou HTML) permettent de realiser une redirection 
dans un script PHP. Chacune a ses avantages et ses inconvenients. Nous les presentons ci-dessous 
afin que vous puissiez utiliser la technique la plus adaptee a vos besoins. 

Redirection en PHP 

La fonction header( ) permet de rediriger l'intemaute vers une page ou une URL sans intervention de 
sa part. L inconvenient de cette fonction est que vous devez toujours l'utiliser avant tout envoi vers le 
navigateur, qu'il s'agisse de codes HTML ou d'affichages provoques par des fonctions PHP comme 
echo( ) ou print( ). II faut done veiller a ce que cette fonction soit appelee au debut du script. 

Tableau 9-15. Fonction de redirection header() 

Syntaxe 

header ( " Location :nom_cibl e" ) 

Legende : nom_cibl e : la cible vers laquelle on redirige l'intemaute peut etre un chemin relatif comme monf i chier .php 
ou un chemin absolu comme http://www.agencew.com. 

Voici un exemple de redirection PHP par la fonction header ( ) : 
<?php 

/* Ce script permet de rediriger l'intemaute vers la page "suite. php" */ 
header ( "Location : suite. php" ) ; 

?> 
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Voici maintenant un exemple de redirection PHP par la fonction header( ) conditionnee par l'instmction 
if : 

<?php 

// Ce script permet de rediriger 1'internaute selon 1'etat de la variable 
//Sprofil vers la page suite. php 
if ($profil=="admin") 
header ( "Location: suite. php" ) ; 

?> 

Redirection en JavaScript 

JavaScript possede egalement une fonction de redirection, que vous pouvez exploiter dans le meme 
contexte. Pour ce faire, utilisez la methode windows.location( ). Vous pouvez emuler le script Java- 
Script grace a la fonction echo( ), comme pour une balise HTML, sinon il est place en dehors des balises 
PHP (voir les exemples ci-dessous). Cette solution peut etre utilisee a tout endroit de la page, contrai- 
rement a la fonction header(). Elle peut egalement etre temporisee si on l'utilise avec la fonction 
setTimeout( ). 

Voici un exemple de redirection JavaScript emulee par la fonction echo( ) : 
<?php 

// Ce script permet de rediriger 1'internaute vers la page suite. php 
echo "<script language=\"JavaScript\" type=\"text/javascript\">"; 
echo " document. 1 oca tion=\"suite.php\" ; " ; 
echo "</script>"; 
?> 

Voici maintenant un exemple de redirection instantanee avec JavaScript : 
<?php 

// Le script PHP de cette page est execute puis 1'internaute est 
//redirige vers la page "suite. php". 

?> 

<script language="JavaScript" type="text/javascript"> 
<!-- 

document. location=" suite. php" ; 

//--> 

</script> 

Ce troisieme exemple montre une redirection temporisee avec JavaScript : 

<script language="JavaScript" type="text/javascript"> 
<! — 

function redirection(){ 
document. 1 oca tion=" suite. php" ; 

} 

//--> 
</script> 
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<body onLoad="setTimeout( ' redi recti on ( ) ' ,2000)"> 
<?php 

echo "Vous allez bientot etre redirige"; 

/* Ce script permet de rediriger l'internaute vers la page "suite. php" apres une 
^♦temporisation reglable. */ 

?> 

L'exemple ci-dessous montre une redirection instantanee avec JavaScript et conditionnee par 
l'instruction PHP if : 

<?php 

// L'internaute est redirige vers la page "suite. php" 
//selon la valeur de la variable "$admin" 
if($profil=="admin") 

{// Debut du bloc conditionne 

?> 

<script 1 anguage="JavaScript" type="text/javascript"> 
<!- 

document .1 oca tion=" suite. php" ; 

//--> 

</script> 

<?php 

}// Fin du bloc conditionne 

?> 

Redirection en HTML 

Une troisieme possibilite permet de rediriger un internaute vers une autre page. Elle consiste a utili- 
ser la balise meta Ref resh du HTML. Comme pour le JavaScript, vous pouvez soit emuler cette balise 
par la fonction echo au sein d'un script PHP, soit l'exploiter normalement en dehors des balises PHP. 
Cette balise peut etre utilisee a tout endroit de la page, contrairement a la fonction header( ). Elle peut 
egalement etre temporisee en fonction des besoins (l'attribut content indique le nombre de secondes 
de la temporisation). 

Voici un exemple de redirection instantanee avec la balise meta emulee par la fonction echo( ) : 
<?php 

echo "<meta http-equiv=\"Ref resh\" content=\"0; url=suite.php\">" ; 
?> 

Ce deuxieme exemple est une redirection temporisee avec la balise meta en dehors des balises PHP : 
<?php 

echo "Vous allez bientot etre redirige"; 
?> 

<meta http-equiv="Ref resh" content="2; url=suite.php"> 
Ce troisieme exemple est une redirection avec la balise meta conditionnee par l'instruction PHP i f : 
<?php 

// L'internaute est redirige vers la page suite. php 
//selon la valeur de la variable $admin. 
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if ($profil=="admin") 

{// Debut du bloc conditionne 

?> 

<meta http-equiv="Refresh" content="0; url=suite.php"> 
<?php 

}// Fin du bloc conditionne 
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ActionScript 
et la programmation structuree 



Comme en PHP, ActionScript met a votre disposition plusieurs structures qui permettent de diviser le 
programme en de multiples sous-programmes (function( )) et de controler son deroulement en utili- 
sant des structures de choix (if, else...) ou de boucle (while, for...). Cette partie vous presente les 
principales structures utilisees lors de la realisation de programmes elabores. 

Portee des variables 

Definition d'un bloc 

On appelle « bloc » F ensemble des instructions delimite par une accolade ouvrante { et fermante }. 
Exemple de bloc : 
{ 

message="bonjour" ; 
trace(message) ; 
} 

Dans le chapitre 7, nous avons presente les gestionnaires d'evenements qui utilisent des blocs pour 
delimiter les instructions executees lorsque l'evenement est detecte. Cependant, les blocs sont 
egalement utilises dans d'autres structures tel que les fonctions ou les structures de choix et de 
boucle. 



Programmation structured 

Partie III 



Portee d'une variable locale 

Lorsqu'une variable est declaree dans un bloc, elle est consideree comme une variable locale. Sa 
portee est limitee aux frontieres du bloc (entre les deux accolades). De meme, les parametres trans- 
mis a une fonction (arguments) sont considered comme des variables locales. Leur portee est limitee 
au bloc de la fonction. Cela evite d'eventuels conflits entre des variables de meme nom declarees 
dans des blocs differents, ce qui limite les risques d'erreur. On peut ainsi utiliser les merries noms de 
variables dans differents blocs sans risque d' alteration de leur contenu par un script externe puisque 
leur temps de vie est limite aux frontieres du bloc (elles sont detruites automatiquement a la sortie de 
celui-ci). En pratique, c'est particulierement interessant lors de l'utilisation de variables generiques 
(comme 1 ou x) pour mettre en place des compteurs de boucle ou des drapeaux (variables booleennes 
utilisees pour memoriser un etat) sans se soucier de Fusage de ces memes variables a l'exterieur du 
bloc. 

Exemple (ce script est declare dans une image cle du scenario principal (_root)) : 

// Declaration d'une variable de scenario 
afficheMessage=function( ) { 

var monNom :String="Dupond" ; 

traceC'Dans le bloc : bonjour Monsieur "+monNom) ; 

} 

// Appel de la fonction (pour affichage de la variable depuis l'interieur du bloc) 
afficheMessage( ) ; 

// L'utilisation externe d'une variable locale n'est pas possible 
traceCEn dehors du bloc : bonjour Monsieur "+monNom) ; 

Apres execution de ce script, le message suivant est affiche dans le panneau Sortie : 

I Dans le bloc : bonjour Monsieur Dupond 

En dehors du bloc : bonjour Monsieur undefined 

La premiere ligne du message correspond a Faffichage de la valeur de la variable monNom a l'interieur 
du bloc (Dupond). La deuxieme ligne du message demontre que cette meme variable n'est plus valide 
a l'exterieur du bloc (undefined). 



Portee d'une variable de scenario 

Une variable declaree dans une image cle reste valide pour tout le scenario dans lequel elle a ete 
declaree. 

A noter 

A I'inverse des variables locales, les variables de scenario peuvent franchir les frontieres du bloc et etre exploitees 
dans n'importe quel bloc de ce scenario. 



Exemple (ce script est declare dans une image cle du scenario principal (_root)) : 

// Declaration d'une variable de scenario 
var monNom :String="Dupond" ; 

// Declaration de la fonction et de son bloc 
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afficheMessage=function( ) ( 

traceCDans le bloc : bonjour Monsieur "+monNom); 
} 

// Appel de la fonction (pour affichage de la variable depuis l'interieur du bloc) 
afficheMessage( ) ; 

// Affichage de la valeur de la variable de scenario 
traceCEn dehors du bloc : bonjour Monsieur "+monNom) ; 

Apres execution de ce script, le message suivant est affiche dans le panneau Sortie : 

Dans le bloc : bonjour Monsieur Dupond 

En dehors du bloc : bonjour Monsieur Dupond 

La premiere ligne du message correspond a F affichage de la valeur de la variable de scenario monNom 
a l'interieur du bloc (Dupond) et demontre qu'une variable de scenario est valide a l'interieur d'un 
bloc. La deuxieme ligne du message affiche la variable de scenario qui reste valide dans tout le scenario 
de F animation (Dupond). 



Portee d'une variable globale 

Appel d'une variable de scenario a I'aide de son chemin cible 

Meme si 1' appel simple d'une variable de scenario (on ne mentionne que son nom sans preciser le 
chemin cible de la variable) est limite a son propre scenario, elle reste cependant valide dans les 
autres scenarios (contrairement aux variables locales, qui sont detruites a l'exterieur du bloc). Pour 
appeler une variable de scenario depuis un scenario externe, il suffit de preciser son chemin cible 
(voir le chapitre 7 consacre aux bases du langage ActionScript). 

Exemple (le script ci-dessous est declare dans une image cle d'un clip monCl i pl_mc situe sur le scenario 
principal) : 

// Declaration d'une variable 

// dans le scenario du clip monClipl_mc 

var monNom :String="Dupond"; 

// Appel interne de la variable de scenario 

// place sur le scenario du clip monClipl_mc 

trace( "Appel interne au scenario : bonjour Monsieur "+monNom); 

Le script ci-dessous est place sur le bouton monBoutonl_mc situe sur le scenario principal : 

// Appels externes de la variable de scenario 
// place dans le gestionnaire d'un bouton 
// situe sur le scenario principal 
on (press) { 

traceC'Appel externe sans chemin : bonjour Monsieur "+monNom); 

trace( "Appel externe avec chemin : bonjour Monsieur "+_root.monCl ipl_mc. monNom) ; 

} 

Apres execution de ce script, le message suivant est affiche dans le panneau Sortie : 

Appel interne au scenario : bonjour Monsieur Dupond 
Appel externe sans chemin : bonjour Monsieur undefined 
Appel externe avec chemin : bonjour Monsieur Dupond 
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Cet exemple demontre que pour appeler une variable declaree dans un scenario specifique (par exem- 
ple, le scenario de F occurence de clip monCl i pl_mc), il faut preciser son chemin cible absolu (comme 
dans l'exemple ci-dessous) ou relatif. 

Appel d'une variable de scenario globalisee 

II existe une autre solution pour appeler une variable de scenario sans avoir a preciser son chemin. 
Elle consiste a declarer la variable globalement a Faide du mot-cle _global. Elle pourra ainsi etre 
appelee depuis n'importe quel scenario du projet sans qu'il soit necessaire de preciser son chemin 
cible. 

Exemple (le script ci-dessous est declare dans une image cle d'un clip monCl i pl_mc situe sur le scenario 
principal) : 

// Declaration d'une variable globale 

// dans le scenario du clip monClipl_mc 

_gl obal .monNom="Dupond" ; 

// Appel interne de la variable de scenario 

// place sur le scenario du clip monCl ipl_mc 

trace( "Appel interne au scenario : bonjour Monsieur "+monNom); 

Le script ci-dessous est place sur le bouton monBoutonl_mc situe sur le scenario principal : 

// Appel externe de la variable de scenario 
// place dans le gestionnaire d'un bouton 
// situe sur le scenario principal 
on (press) { 

traceC'Appel externe sans chemin : bonjour Monsieur "+monNom) ; 

} 

Apres avoir appuye sur le bouton, le message suivant est affiche dans le panneau Sortie : 

Appel interne au scenario : bonjour Monsieur Dupond 
Appel externe sans chemin : bonjour Monsieur Dupond 

Ce second exemple demontre qu'une variable declaree comme variable globale dans un scenario peut 
ensuite etre appelee uniquement grace a son nom (sans son chemin cible) depuis tous les scenarios du 
projet. 

Appel d'une variable de bloc globalisee 

Si nous declarons une variable globale a Finterieur d'un bloc, cette derniere pourra etre appelee de la 
meme maniere depuis tous les scenarios du projet mais aussi depuis tous les autres blocs de ceux-ci. 

Exemple (le script ci-dessous est declare dans une image cle de Foccurrence de clip monCi pl_mc situe 
sur le scenario principal) : 

// Declaration de la fonction 
// avec une variable globale 
afficheMessage=function( ) { 
_gl obal .monNom="Dupond" ; 
traceC'Dans le bloc : bonjour Monsieur M +monNom) ; 

} 
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II Appel de la fonction (pour affichage 

// de la variable depuis 1'interieur du bloc) 

afficheMessaget ) ; 

// Affichage de la variable 

// globale a 1'exterieur du bloc 

traceCEn dehors du bloc : bonjour Monsieur "+monNom); 

Le script ci-dessous est place sur le bouton monBoutonl_mc situe sur le scenario principal : 

// Appel externe au scenario 
// de la variable globalised, 
on (press) { 

traceC'Appel externe sans chemin : bonjour Monsieur "+monNom) ; 

} 

Apres execution de ce script, le message suivant est affiche dans le panneau Sortie : 

Dans le bloc : bonjour Monsieur Dupond 

En dehors du bloc : bonjour Monsieur Dupond 

Appel externe au scenario sans chemin : bonjour Monsieur Dupond 

Cet exemple demontre qu'une variable declaree comme globale a 1'interieur d'un bloc etend sa 
portee a 1'exterieur des frontieres de ce bloc et done au scenario dans lequel se trouve le bloc, mais 
aussi a tous les scenarios et a tous les scripts du projet. La variable peut desormais etre referencee 
depuis n'importe quel endroit du projet. Elle peut aussi etre modifiee, voire supprimee, de la meme 
maniere. Cela represente un danger, car les variables d'un bloc risquent d'etre alterees par erreur 
depuis un autre script utilisant une variable de meme nom. II faut done etre extremement prudent et 
exploiter la declaration d'une variable globalised dans un bloc uniquement lorsque e'est indispensa- 
ble. D' autre part pour eviter les conflits entre une variable locale et une variable globale, nous vous 
conseillons de nommer vos variables globales en ajoutant le prefixe glob_ a leur identifiant 
(exemple : globjonNom). 



Fonctions utilisateur 

Jusqu'a present nous avons utilise uniquement les fonctions integrees de Flash (trace( ) ou typeof ( ), 
par exemple) ou encore les differentes methodes des classes d'objets presentees precedemment (les 
methodes fonctionnent en quelque sorte comme des fonctions qui seraient exclusivement dediees a 
certaines classes d'objets). 

Cependant, comme en PHP, ActionScript vous permet de creer vos propres fonctions utilisateur afin 
de disposer d' instructions correspondant exactement aux taches que vous devez effectuer. 

A la difference des fonctions integrees, les fonctions utilisateur doivent etre declarees avant de 
pouvoir etre reutilisees autant de fois que necessaire dans la suite du programme. L' usage des fonc- 
tions utilisateur evite d' effectuer de multiples copier-coller du meme code et facilite la maintenance 
du programme (en cas de modification, il suffit d'intervenir uniquement sur les instructions de la 
declaration initiale). 
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Une fonction utilisateur peut simplement executer un script ou renvoyer la valeur d'un resultat 
a 1' expression qui a initie l'appel de la fonction (a l'aide du mot-cle return suivi du resultat a 
retourner). 

Afin d'obtenir une fonction generique qui executera toujours les merries actions, une fonction sans 
information entre les parentheses peut etre creee. Cependant, il est souvent interessant de transmettre 
des informations a la fonction afin de la personnaliser. Ces informations (nominees arguments ou 
encore parametres) seront indiquees entre parentheses et separees par une virgule. 



Declaration et utilisation des fonctions 

Avant d'utiliser une fonction, il est imperatif de 1' avoir declaree (en pratique, les fonctions sont 
frequemment declarees dans l'image 1 du scenario dans lequel elles sont utilisees). Pour declarer une 
fonction, utilisez le mot-cle function. Deux syntaxes peuvent etre utilisees, mais la syntaxe d'utilisation 
de la fonction est commune aux deux types de declaration (voir tableau 10-1 ci-dessous). 



Raccourci pour declarer une fonction 

Vous pouvez afficher rapidement la structure d'une declaration de fonction en utilisant le raccourci clavier 
Esc + fn. La structure ci-dessous s'affiche automatiquement dans le panneau Action. Le pointeur est positionne 
automatiquement a droite du mot-cle function pour la saisie du nom de la fonction : 

function _( ) { 
} 

De meme, pour saisir rapidement le mot-cle return, vous pouvez utiliser le raccourci clavier Esc + rt qui affiche 
I'expression ci-dessous avec le curseur prepositionne entre les parentheses pour la saisie du nom de la variable 
qui sera retourne par la fonction : 

return (_); 



Tableau 10-1. Fonctions utilisateur 



Syntaxe 1 de la declaration d'une fonction 

function nom_de_fonction (argl : typeArgumentl ,arg2: typeArgument2,._) 

1 

instruction!; 
instruction2; 

[return (monResul tat) ; ] 
} 




Syntaxe 2 de la declaration d'une fonction 

nom_de_fonction = function (argl :typeArgumentl , arg2: typeArgument2 ,...) 

{ 

i nstructionl ; 
instruction2; 



[return (maVarO);] 
} 
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Tableau 10-1. Fonctions utilisateur (suite) 

Syntaxe commune d'utilisation d'une fonction 

nom_de_fonction (argl,arg2...) ; 

Remarques : Le nom de la fonction ne doit comporter ni espace ni point. 

Les parentheses permettent de passer des arguments separes par des virgules. 

Les arguments peuvent etre declares et types directement dans la parenthese. 

Les arguments peuvent etre des variables ou des constantes. 

La duree de vie d'une variable de fonction est limitee au temps d'execution de la fonction. 

return permet de retourner une variable resultat monResul tat dans le programme mais sa presence n'est 

pas obligatoire. 

[xxx] : le code xxx est facultatif 

(Attention ! vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 
Exemple (creation d'une fonction moyenneO pour le calcul de la moyenne de deuxvaleurs) : 

// Declaration de la fonction 

function moyenne (maVarl:Number,maVar2:Number) //tete de la declaration 
{ // Debut du corps 

var monResultat:Number=(maVarl+maVar2)/2; // Instructions de la fonction 

return (monResul tat) ; // Information retournee au programme 

} // Fin du corps 

// Utilisation de la fonction dans le programme 

monCalcul=moyenne(4,6) ; //appel de la fonction 

trace( "la moyenne de 4 et de 6 est egale a"+ monCalcul); 



Appel d'une fonction 

Appel d'une fonction depuis le scenario dont elle depend 

Avant de presenter la syntaxe d' appel d'une fonction, nous vous rappelons qu'avant d'utiliser une 
fonction, il est imperatif de 1' avoir declaree au prealable. Si vous utilisez la fonction dans le meme 
scenario que sa declaration, il suffit de rappeler son nom en precisant les eventuels parametres en 
argument. 

Exemple : 

// La declaration de fonction ci-dessous a ete saisie dans 1 'image cle 1 de 1 'animation 
^•principale (_root) 

afficheAccueil=function(monNom:String) { 
tracet "bonjour Monsieur M +monNom); 

} 

// L'appel de la fonction ci-dessous est integre dans un gestionnaire d'evenements de souris 
^•applique a un bouton lui aussi place sur 1 'animation principale (_root) 
on (press) ( 
afficheAccueil ("Dupond") ; 

} 

Si Ton clique sur le bouton, le panneau Sortie affiche le message suivant : 
bonjour Monsieur Dupond 
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Appel d'une fonction depuis un autre scenario 

Si vous desirez appeler une fonction depuis un autre scenario, le scenario dans lequel elle a ete decla- 
ree doit etre utilise pour construire le chemin cible. Comme pour tous les elements Flash, vous 
pouvez utiliser differents types de ciblage pour appeler la fonction (revoir le chapitre 7 consacre aux 
bases d'ActionScript). 

Exemple : 

// La declaration de fonction ci-dessous a ete saisie 
// dans 1 'image cle 1 du clip monCl ipl_mc place 
// sur 1 'animation principale 
afficheAccueil=function(monNom:String) { 
trace( "bonjour Monsieur "+monNom); 

} 

// L'appel de la fonction ci-dessous est integre 
// dans un gestionnaire d'evenements de souris 
// applique a un bouton place di rectement sur 
// 1 'animation principale (_root) 
on (press) { 
_root.monClipl_mc.afficheAccueil ("Dupond") ; 

} 

Dans notre exemple, nous avons declare la fonction dans le clip monCl ipljnc. Par consequent, il est 
necessaire d'utiliser le ciblage absolu_root. monCl ipl_mc.afficheAccueil ( ) pour referencer la fonction. 
Ainsi, si Ton clique sur le bouton, le panneau Sortie affiche le message suivant, comme dans le 
premier exemple : 

bonjour Monsieur Dupond 
Appel d'une fonction globalisee 

Comme vous declarez des variables globales (a l'aide du mot-cle _gl obal ) afin qu'elles soient acces- 
sibles depuis tous les scenarios d'un meme projet, vous pouvez utiliser la meme syntaxe pour rendre 
accessible une fonction depuis n'importe quel scenario sans avoir a preciser son chemin cible. Ainsi 
une fonction utilisateur peut etre appelee aussi simplement qu'une fonction Flash integree (par 
exemple : trace( "bonjour")). 

Exemple : 

// La declaration globalisee de fonction ci-dessous a 
// ete saisie dans 1 'image cle 1 de 1 'animation 
// principale 

_global .afficheAccueil=function(monNom:String) { 
tracet "bonjour Monsieur "+monNom); 

} 

// L'appel de la fonction ci-dessous est integre 
// dans un gestionnaire d'evenements de souris applique 
// a un bouton place sur un scenario different 
on (press) { 
aff icheAccuei 1 ( "Dupond" ) ; 

} 
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Dans notre exemple, nous avons declare la fonction globalisee dans V animation principale (_root). 
Nous pourrons l'appeler depuis n'importe quel scenario du projet sans avoir a preciser son chemin 
cible. Lorsqu'on clique sur le bouton, le panneau Sortie affiche le message suivant, comme dans le 
premier exemple : 

bonjour Monsieur Dupond 

Une fonction globalisee est simple d' utilisation. L'employer vous evite d'alourdir vos scripts avec 
des chemins cibles inutiles et vous permet de placer le script utilisant la fonction dans n'importe quel 
scenario sans modifier son code. En pratique, des qu'une fonction doit etre appelee depuis differents 
scenarios, il est judicieux de la declarer comme une fonction globalisee dans 1' image 1 du scenario 
principal. 

Appel dynamique d'une fonction 

II est souvent interessant d'appeler dynamiquement une fonction en substituant a son nom le contenu 
d'une simple variable. II faut alors utiliser les symboles crochets [ et ] pour evaluer cette variable et 
appeler la fonction : 

_root[maVariabl e] ( ) ; 

Dans cet exemple, la variable maVari abl e a ete initialisee au prealable avec le nom de la fonction a 
appeler : "maFoncti on". L' execution de l'appel dynamique equivaut a l'appel de fonction ci-dessous : 

_root.maFonction( ) ; 

Exemple : 

// La declaration de fonction ci-dessous a 
// ete saisie dans 1 'image cle 1 de 1 'animation principale 
afficheAccueil=function(monNoin:String) { 
trace( "bonjour Monsieur "+monNom); 

} 

// L'appel de la fonction ci-dessous est realise 
// dynamiquement depuis un gestionnaire d'evenements 
// de souris applique a un bouton place sur 
// un scenario quelconque 
on (press) { 
x="afficheAccueil " ; 
_root[x] ( "Dupond" ) ; 

} 

Dans notre exemple, nous avons declare la fonction dans 1' animation principale (_root) et nous 
l'avons appelee dynamiquement depuis un scenario quelconque du projet. La variable x etant initiali- 
see avec la valeur "afficheAccueil " (nom de la fonction appelee), revaluation de l'instruction 
d' appel dynamique equivaut a l'instruction suivante : 

_root. afficheAccueil ("Dupond") ; 

Par consequent, lorsqu'on clique sur le bouton, le panneau Sortie affiche le message suivant, comme 
dans le premier exemple : 

bonjour Monsieur Dupond 
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Fonction generique 

Les parentheses de la fonction permettent de passer des parametres en argument arm de personnaliser 
son execution. Si vous laissez ces parentheses vides, vous creez une fonction generique qui sera 
executee de la meme maniere lors de chaque appel. 

Exemple : 

// Declaration de la fonction generique 
ditBonjour=function( ) { 
tracet "Bonjour Monsieur"); 

} 

// Appel de la fonction generique 
ditBonjourt ) ; 

// Chaque appel de cette fonction affichera toujours « Bonjour Monsieur » 

Fonction avec passage d'arguments 

Passer les arguments avec des constantes ou des variables 

Lors de l'appel d'une fonction, les arguments peuvent etre indiques entre les parentheses a l'aide de 
constantes ou de variables. 

Les deux appels de fonction suivants sont identiques : 

monCalcul=moyenne(4,6) ; 

est identique au script ci-dessous : 

var maVarl : Number=4; 
var maVar2:Number=6; 
monCal cul=moyenne(maVarl ,maVar2) ; 



A noter 

Dans le cas ou la constante passee en argument est de type texte, il faut utiliser des guillemets pour encadrer sa 
valeur entre les parentheses. 



Exemple d'une fonction affichant le texte "Bonjour" dans le panneau Sortie lors de son appel : 

af f i cheTexte=f uncti on (monTexte : Stri ng ) { 
trace(monTexte) ; 

} 

af f i cheTexte( "Bonjour" ) ; 

Respectez I'ordre des arguments 

Lorsque vous envoyez plusieurs informations en argument lors de l'appel d'une fonction, respectez 
I'ordre qui a ete utilise lors la declaration de la fonction. 
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Par exemple, pour utiliser la fonction afficheAge( ) ci-dessous, il est imperatif de respecter l'ordre 
des arguments utilises dans la declaration de la fonction : 

af f i cheAge=f unct i on (age: Number, nom: St ring) { 
trace( "L'age de "+nom+" est "+age); 
} 

L'appel ci-dessous est correct : 

afficheAge(23, "Alain"); 
L'appel suivant est incorrect : 

afficheAgeC'Alain" ,23) ; 

Utilisez le bon nombre d'arguments 

Lors de l'appel d'une fonction, il faut respecter le type des arguments indiques lors de la declaration 
de celle-ci (comme nous venons de le voir ci-dessus) mais aussi leur nombre. Si une valeur d' argu- 
ment est omise lors de l'appel d'une fonction, elle sera consideree comme variable indefinie (undef i ned) 
s'il s'agit du dernier argument. Une erreur d'incompatibilite de type sera generee si vous avez pris le 
soin de preciser le type de chaque argument dans la declaration de la fonction (par exemple : 
aff icheAge( age: Number, nom: St ring)). 

Par exemple, si nous reprenons la fonction aff i cheAge( ) precedente et si nous l'appelons en omettant 
le deuxieme argument : 

afficheAge(23); 

la variable nom est consideree comme indefinie et le message suivant est affiche dans le panneau 
Sortie : 

L'age de undefined est 23 
De meme, si nous appelons la fonction en omettant le premier argument : 

afficheAgeC'Alain"); 
le message d' erreur suivant est affiche : 

**Erreur** : Incompatibility de types. 

A l'inverse, si le nombre d'argument est superieur a celui qui a ete defini lors de la declaration de la 
fonction, le dernier argument sera ignore si les types des precedents arguments correspondent a ceux 
de la declaration originelle. 

Dans F exemple suivant, un argument supplementaire a ete ajoute lors de l'appel de la fonction : 
I afficheAge(23, "Alain" , "Dupond") ; 

Dans ce cas, le processus de la fonction n'est pas perturbe et l'affichage est correct mais le dernier 
argument n'est pas exploite : 

L'age de Alain est 23 
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Declaration d'arguments optionnels 

Pour eviter les messages d'erreur en cas d' omission du dernier argument (voir ci-dessus) ou pour 
configurer une fonction avec un ou plusieurs arguments optionnels, il suffit d'ajouter une instruction 
de test au debut du script pour chaque argument optionnel. 

A noter 

Les arguments optionnels doivent imperativement etre places en dernier dans la liste des arguments de la fonction 
afin de conserver la correspondance de type des autres arguments de la fonction. 



Dans Fexemple suivant, le second argument est optionnel. En cas d' absence du nom, celui-ci sera 
remplace automatiquement par la valeur "mon ami " : 

afficheAge=f unction (age: Number, nom: String) ( 
if (nom==undefined) {nom=" mon ami";} 
traceCL'age de "+nom+" est "+age); 

} 

Si Ton appelle la fonction avec un seul argument : 

afficheAge(23); 
le message suivant est affiche dans le panneau Sortie : 

L'age de mon ami est 23 

Utilisation du tableau temporaire des arguments 

A chaque appel d'une fonction avec passage d'arguments, un tableau temporaire nomme arguments 
est cree automatiquement. II contient toutes les valeurs des arguments indiques entre les parentheses 
lors de 1' appel de la fonction (meme si aucun argument n'a ete specifie lors de la declaration initiale 
de la fonction). II est possible d'exploiter son contenu dans le bloc de la fonction en utilisant les 
merries methodes et proprietes que pour un objet Array traditionnel (revoir si besoin le chapitre7 
consacre aux objets integres). 

Nous allons creer une fonction d'affichage qui s'adaptera automatiquement au nombre d' argument 
precise lors de 1' appel de la fonction. 

Dans cet exemple, la declaration de la fonction ne precise aucun argument predefini (pour plus 
d'information sur les boucles ActionScript utilisees dans Fexemple ci-dessous, reportez-vous a la 
section consacree aux boucles plus loin dans ce chapitre) : 

// — Declaration de la fonction 
afficheListe=function( ) { 

var compteur: Number = arguments . 1 ength ; 
// Affectation du nombre d'arguments passes a la 
// fonction (correspondent au nombre d'elements 
// du tableau "argument") a une variable nommee "compteur" 

traceCvoici la liste des arguments :"); 

while (compteur>0) { 
compteur-- ; 

t race ( ">"+arguments [compteur] ) ; 
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} 

} 

// — Utilisation de la fonction 
affichel_iste( "Al ain" , "Jean" ) ; 

L' execution de ce script affiche le texte suivant dans le panneau Sortie : 

voici la liste des arguments : 
>Jean 
> Alain 



Fonction avec gestion du resultat 
Fonction sans retour de resultat 

Une fonction peut se contenter de realiser une action sans necessiter le retour d'un resultat. Dans ce 
cas, le bloc de la fonction ne comporte pas d' action return. 

Exemple : 

// Declaration d'une fonction sans retour de resultat 
cal cul Stat=f unct i on ( pa ral: Number, pa ra2: Number) { 
var somme:Number=paral+para2; 
traceCLa somme est "+somme); 

} 

Si Ton appelle la fonction : 

calculStat(10.20) ; 
le message suivant est affiche dans le panneau Sortie : 

La somme est 30 

Fonction avec retour d'une simple variable 

Les fonctions peuvent recevoir des parametres (arguments) mais elles peuvent aussi en retourner. 
Dans ce cas, il faut utiliser Taction return en indiquant le nom de la variable qui contient le resultat. 

Exemple : 

// Declaration d'une fonction avec retour de resultat 
cal cul Stat=functi on (paral: Number, para2: Number) { 
var somme:Number=paral+para2; 
return(somme) ; 
} 

Si Ton execute les deux lignes de code ci-dessous : 

resultat=calculStat(10,20) ; 
traceCLa somme est "+resultat); 

le message suivant est affiche dans le panneau Sortie : 

La somme est 30 
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Pour bien comprendre le fonctionnement de Taction return, il faut considerer que la variable indi- 
quee entre les parentheses de return (soit somme dans l'exemple precedent) se substitue a l'expression 
d'appel de la fonction (soit calculStat(10,20) dans l'exemple precedent). 

Au final, lors de l'appel de la fonction, la ligne de code : 

resultat=calculStat(10,20); 
equivaut a F instruction suivante (avec la valeur 30 affectee prealablement a la variable somme) : 
j resultat=somme; 

II est done normal que la deuxieme ligne de code : 

traceCLa somme est "+resul tat) ; 
affiche le message suivant dans le panneau Sortie : 

La somme est 30 

Fonction avec retour de plusieurs variables 

L' action return ne peut retourner qu'un seul element entre parentheses. Cependant, dans certaines 
fonctions, il est necessaire de retourner plusieurs variables au programme appelant. II est alors possi- 
ble de retourner un objet Array a la place d'une simple variable. Dans ce cas, il suffit d'enregistrer les 
differentes variables dans le tableau Array avant d'executer Taction return dans la fonction, puis de 
les extraire du tableau apres Tappel de la fonction dans le programme appelant. 

Exemple : 

// Declaration d'une fonction avec plusieurs resultats dans un Array 

cal cul Stat=f unct i on ( pa ral: Number, pa ra2: Number) { 

var res :Array=new ArrayO; 

res[0]=paral+para2; 

res[l]=res[0]/2; 

return(res) ; 

} 

// Appel de la fonction 
resultat=calculStat(10,20); 

// Affichage des resultats a l'exterieur du bloc 

traceCEn dehors du bloc : somme= "+resul tat[0]+" et moyenne ="+resultat[l] ) ; 
Apres Tappel de la fonction, le message suivant est affiche dans le panneau Sortie : 
En dehors du bloc : somme= 30 et moyenne =15 

Autres solutions pour retourner le resultat d'une fonction 

Pour transmettre plusieurs resultats apres T execution de la fonction, il existe une alternative a 
Temploi d'un tableau Array. Elle consiste a utiliser une variable globale accessible a la fois depuis le 
bloc de la fonction et le programme appelant (revoir si besoin la portee d'une variable de bloc globa- 
lised presentee en debut de ce chapitre). Les resultats a retourner pourront etre memorises dans ces 
variables globales puis recuperes dans le programme appelant. 
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Exemple (les scripts ci-dessous sont saisis dans une image cle d'un meme scenario) : 

// Declaration d'une fonction 

// avec plusieurs resultats globalises 

cal cul Stat=funct i on (pa ral: Number, pa ra2: Number) { 

_global .somme=paral+para2; 

_global .moyenne=somme/2; 

} 

// Appel de la fonction 
calculStat(10,20) ; 
// Affichage des variables globales 
// a l'exterieur du bloc 

traceCEn dehors du bloc : somme= "+somme+" et moyenne ="+moyenne); 
Si Ton appelle la fonction : 

calculStat(10,20) ; 
le message suivant est affiche dans le panneau Sortie : 

En dehors du bloc : somme= 30 et moyenne = 15 



Commentez vos declarations de fonctions 

Des que vous creez une fonction, integrez-y des le debut du bloc de nombreux commentaires. Cet en-tete vous 
permet de preciser les actions realisees par la fonction mais aussi quels sont les arguments acceptes en n'oubliant 
pas d'indiquer leur type (texte, numerique, booleen...) ou encore sous quelle forme seront retournes le ou les 
resultats au programme appelant. 
Exemple : 

cal cul St at=f unct ion (pa ral : Number, pa ra2: Number) ( 
/*****************************^ 

* FONCTION DE STATISTIQUE calculStat 

* Entrees 2 arguments : valeurs numeriques a analyser 

* Sorties 2 resultats renvoyes avec return de type Array avec : 

* - I'indice 0 = la somme des 2 valeurs 

* - I'indice 1 = la moyenne des 2 valeurs 
*****************************^ 

var res : Array=new ArrayO; 
res[0]=paral+para2 ; 
res[l]=res[0]/2; 
return(res) ; 

} 



Bibliotheques de fonctions externes 

Au cours de vos developpements, vous aurez certainement F occasion de creer de nombreuses fonc- 
tions utilisateur. Pour capitaliser ces scripts, archivez-les afin d'en disposer rapidement dans tous vos 
projets. 

II existe plusieurs methodes pour archiver ces fonctions. La plus simple consiste a les enregistrer 
dans un document specifique pour pouvoir ensuite les copier puis les inserer dans le scenario de votre 
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choix. Vous pouvez aussi creer un modele de scenario dans lequel les fonctions sont integrees dans 
F image cle 1. Ainsi dans chaque nouveau scenario cree a partir de ce modele, vous disposerez auto- 
matiquement des fonctions originelles. La troisieme solution consiste a creer un fichier externe dans 
lequel sont rassemblees les fonctions. II suffit ensuite de l'appeler a Faide de l'instruction #include 
pour en disposer dans votre projet. Les fonctions regroupees dans ces fichiers externes peuvent etre 
classees par theme afin de creer des bibliotheques de fonctions. 

Tableau 10-3. Instruction #include 

Syntaxe de l'instruction ffinclude 

#incl ude "nom_du_f ichier .as" ; 
Remarques : 

Lextension .as du fichier nom_du_f ichier indique qu'il contient du code ActionScript. Ces fichiers sont frequemment utilises 
pour regrouper des declarations de fonctions dans des bibliotheques externes ou pour definir une classe d'objet (la creation 
d'une classe d'objet sera presentee dans un prochain chapitre). 

Un fichier .as peut etre declare directement dans I'interface Flash (menu Fichier, puis Nouveau et Fichier ActionScript) ou en 
utilisant un editeur externe comme le bloc-notes. 

Cette derniere solution etant la plus interessante, nous vous proposons de Fillustrer en reprenant le 
document de l'exemple utilise precedemment pour l'etude d'une fonction avec retour d'une simple 
variable : 

1. Dans F image cle 1, selectionnez puis coupez le script correspondant a la declaration de la fonction, 
soient les lignes de codes suivantes : 

// Declaration d'une fonction avec retour de resultat 
calculStat=function(paral : Number, pa ra2: Number) { 
var somme:Number=paral+para2; 
return(somme) ; 

} 

2. Ouvrez ensuite un editeur de votre choix (un simple bloc-notes fera 1' affaire) ou utilisez 1' editeur 
Flash du panneau Actions (Menu Fichier, puis selectionnez Nouveau et Fichier ActionScript). 
Collez dans l'editeur les lignes de codes precedemment coupees (voir figure 10-1). Enregistrez 
ensuite le fichier sous le nom mesFoncti ons . as dans le meme repertoire que le document Flash. 

3. Revenez ensuite dans l'image cle 1 du document Flash et copiez l'instruction suivante a la place 
des lignes de code supprimees (voir figure 10-2): 

| #include "mesFonctions.as"; 

4. Testez ensuite votre animation afin de vous assurer qu'elle fonctionne exactement comme dans la 
configuration initiale. 

Vous pouvez ajouter de nombreuses declarations de fonction dans le meme fichier externe et creer 
ainsi vos propres bibliotheques de fonctions. Ces fonctions etant externes au document Flash, il est 
ensuite tres facile de les mettre a jour en modifiant un seul fichier et sans nouvelle publication du 
document. 
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Figure 10-2 

[/ne simple instruction #include inseree dans I 'image cle du scenario principal permet de disposer 
de toutes les fonctions enregistrees dans le fichier mesFonctions.as. 
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Structures de choix 

Structures de choix avec if 

Les structures de choix permettent d'ajouter de l'interactivite a vos projets. En effet, le chemin du 
programme peut etre derive selon diverses conditions (exemple : une reponse saisie par l'utilisateur 
dans un formulaire, l'heure ou la date actuelle ou encore la position de la souris sur la scene). Comme 
en PHP, les structures de choix comprennent une expression de condition qui permet de determiner le 
chemin a prendre. Les expressions de condition sont constitutes de variables ou de constantes reliees 
par des operateurs logiques. Si l'expression de condition entre parentheses est vraie, le bloc 
d'instructions (delimite par les accolades { et }) qui suit est execute ; sinon il ne se passe rien et le 
programme continue son deroulement apres le bloc du i f . 

Tableau 10-4. Instruction conditionnelle if 

Syntaxe 

if (expression_de_condition) 
{ 

i nstruct"i onl ; 
instruction; 

} 

Forme simplifies (s'il n'y a qu'une seule instruction a traiter) : 

if (expression_de_condition) 

instruction!.; 

Exemple : 

if (maVar>4) 

{// Debut du bloc IF 
trace( "la valeur est superieure a 4"); 
trace( "el 1 e est exactement egale a "+maVar); 
}// Fin du bloc IF 

Structures de choix avec if et else 

La structure de choix utilisant l'instruction i f ne traite que les structures de programme ou la condi- 
tion est vraie ; dans le cas contraire, aucune instruction n'est executee. Avec l'instruction el se, vous 
pouvez definir les instructions a executer dans le cas ou la condition testee serait fausse. Ces instructions 
sont regroupees dans un autre bloc qui suit l'instruction el se. 
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Tableau 10-5. Instructions conditionnelles if et else 



Syntaxe 

if ( expressi on_de_conditi on) 

{ 

I instruction].; 
instruction2; 

} 

el se 

{ 

instruction3; 
instruction4; 

T 

Exemple : 

if (maVar>4) 
{ 

trace( "la valeur est superieure a 4"); 
trace( "elle est exactement egale a "+maVar); 
} 

el se 

{// Debut du bloc ELSE 

trace( "la valeur est inferieure ou egale a 4"); 
trace( "elle est exactement egale a "+maVar); 
}// Fin du bloc ELSE 



Structures de choix avec if, else if et else 

En pratique, lors d'un choix, il est frequent d' avoir plusieurs conditions a tester. Dans ce cas, il faut 
utiliser 1'instruction else if, qui est en quelque sorte une combinaison du el se et du i f . Elle se place 
a la suite d'une instruction if pour introduire le bloc a executer au cas ou sa condition serait fausse 
(comme le el se) et introduit une nouvelle condition (comme le if). On peut creer autant de conditions 
imbriquees qu'on le desire selon le nombre d'instructions else if utilisees. 

Tableau 10-6. Instructions conditionnelles if, else if et else 

Syntaxe 

if (expression_de_condition) 
{ 

instructionl ; 
instruction2; 

} 

else if (expression_de_condition) 
{ 

instruction3; 
instruction4; 

} 

el se 
{ 

instruction5; 
instruction6; 



1 
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Exemple : 

if (maVar>4) 
{ 

tracet "la valeur est superieure a 4"); 
trace( "el 1 e est exactement egale a "+maVar); 
} 

else if (maVar>2) 

{// Debut du bloc ELSE IF 

tracet "la valeur est superieure a 2 mais inferieure ou egale a 4"); 
tracet "elle est exactement egale a "+maVar); 
}// Fin du bloc ELSE IF 
el se 
{ 

tracet "la valeur est inferieure ou egale a 4"); 
tracet "elle est exactement egale a "+maVar); 
} 

Structures de choix avec switch ... case 

A la place d'une structure avec plusieurs else if, on peut utiliser une structure exploitant l'instruc- 
tion switch. Elle permet de tester l'egalite d'une valeur passee en parametre (valeurjestee) avec 
une serie de valeurs possibles (valeurl, valeur2...). Si l'une des valeurs correspond a la valeur testee, 
le bloc d' instructions correspondant est execute. Si la structure de votre programme le permet, l'utili- 
sation d'une instruction switch ... case raccourcit votre code et en facilite la lecture. 



A noter 

L'execution des instructions doit se terminer par une instruction break, afin que le programme puisse sortir de la 
structure de choix (sinon le programme passerait automatiquement au mot-cle case suivant). De meme, il est judicieux 
d'ajouter une branche def aul t a la fin d'un bloc afin de traiter tous les cas non prevus dans la structure. 



Tableau 10-7. Instruction switch ... case 



Syntaxe 




switch (valeur_testee) 
( 

case valeurl: 

instruction].; 

break; 
case valeur2: 

instruction2; 

break; 
case valeur3: 

instruction3; 

break; 



default: 
instructionD; 
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Dans l'exemple ci-dessous la tete de lecture de 1' animation est orientee vers une etiquette differente 
(chaque etiquette coiTespond a un ecran d'accueil dans une langue differente) selon la langue que 
l'utilisateur a memorisee dans la variable ma Langue : 

var maLangue:text="fr" ; 

// Cette variable memorise la langue choisie par 1'internaute 

switch(ma Langue) 

{ 

case "fr": 

gotoAndPl ay ( "Bonjour" ) ; 

break; 

case "en": 

gotoAndPl ay ("Hello"); 

break; 

case "es": 

gotoAndPl ay( "Hoi a"); 

break; 

case "de": 

gotoAndPl ay ( "GutenTag" ) ; 

break; 

} 



Declenchement des structures de choix 

Comme tous les scripts ActionScript, les structures de choix peuvent etre declenchees par differents 
types d'evenements selon l'effet desire (test de la condition de choix effectue a un moment specifique 
ou en continu. . .) (voir tableau 10-8). 



Tableau 10-8. Les differents types d'evenement pouvant declencher une structure de choix 



Type d'evenement 


Test de la condition de choix 


Evenement d'image : structure de choix placee dans une 
image cle 


Le test de la condition de choix est realise lorsque la tete de 
lecture arrive sur I'image cle. 


Evenements de souris ou de clip (sauf enterFrame) : 
structure de choix placee dans un gestionnaire d'evene- 
ments de souris ou de clip. 


Le test de la condition de choix est realise lorsque I'evenement 
est detecte (die sur un bouton, touche de clavier actionnee, 
deplacement de souris, chargement d'un clip ou de donnees. . .). 


Evenement enterFrame : structure de choix placee dans 
un moteur de script (gestionnaire de clip enterFrame). 


Le test de la condition de choix est realise en boucle (la frequen ce 
depend de la cadence de I'animation). 



Structures de boucle 

En programmation, vous devrez souvent effectuer plusieurs fois les memes actions. Dans ce cas, 
utilisez une structure de boucle afin d'automatiser F execution de ces actions selon la configuration de 
parametres specifiques a ce type de structure (valeur d' initialisation du compteur de boucle, condi- 
tion de sortie de boucle et pas decrementation ou de decrementation du compteur a chaque tour de 
boucle). ActionScript met a votre disposition plusieurs structures. 
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Structures de boucle avec while 

En ActionScript, la structure la plus simple est realisee a Faide de l'instruction while. Le bloc 
d'instructions est execute et repete tant que l'expression de condition retourne true (vrai). Lorsque 
la condition est ou devient fausse (fal se), le programme sort de la boucle pour executer les instructions 
qui se trouvent apres la fin du bloc. 

Avant d'utiliser une structure whi 1 e, vous devez au prealable initialiser un compteur de boucle. Cette 
variable (la lettre i est frequemment employee comme compteur dans une boucle) est ensuite testee dans 
l'expression de condition, puis incrementee (ou decremented selon les cas) dans le corps de boucle. 

Comme nous l'avons deja mentionne dans la presentation de la boucle whi 1 e PHP, le type d'operateur 
(incrementation ou decrementation) utilise pour le compteur dans le corps de boucle doit etre choisi 
en fonction de la valeur d' initialisation du compteur et de l'expression de condition, sinon vous 
risquez d'obtenir une boucle infinie. 

D'autre pail avec une boucle whi 1 e , la valeur de l'expression de condition etant evaluee avant chaque 
debut de boucle, les instructions du bloc peuvent ne jamais etre executees si la condition est evaluee 
a f al se des le debut (contrairement a la boucle do ... whi 1 e presentee ci-apres). 

Tableau 10-9. Instruction de boucle while 

Syntaxe 

while (expression_de_condition) 
{ 

instruction].; 
instruction?; 

I) 

Exemple 1 (dans l'exemple ci-dessous, un texte qui indique le nombre de tours de boucle restant a 
effectuer est affiche tant que la condition de boucle reste valide. Au terme de la boucle, un texte de fin 
est affiche) : 

var i :Number=5; // Initialisation du compteur de boucle a 5 
while(i>0) 
{ 

tracet "Encore "+i+" tour(s) a faire "); 
--i; // Decrementation du compteur de boucle 
} 

trace( "Voi 1 a , c'est enfin termine"); 

Exemple 2 (dans cet exemple, la boucle while est utilisee pour dupliquer quatre fois le clip 
monCl ip_mc. Les deux autres lignes du corps de boucle permettent d'attribuer des coordonnees diffe- 
rentes a chaque clip duplique en se referant au compteur de boucle i ) : 

var i :Number=0; 
whi led <=4) { 

monCl ipjnc.dupl icateMovieCl ip( "monCl ip"+i+"_mc" , i ) ; 

_root["clip"+i+"_mc"] ._x=100+i*10 ; 

_root["clip"+i+"_mc"]._y=100+i*10; 

++i ; 

} 
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Structures de boucle avec do ... while 

La structure do ... whi 1 e est semblable a la precedente, mais l'expression de condition est evaluee 
apres la premiere execution du bloc (le corps de boucle) : celui-ci est done toujours execute au moins 
une fois, meme si l'expression de condition est fausse des le debut. 



Tableau 10-10. Instruction de boucle do ... while 



Syntaxe 


do 
f 




"instructi onl; 




instruction?; 
} 




while (expression_de_condition) ; 





Voici deux exemples de la meme structure de boucle do ... while avec des valeurs d'initialisation de 
compteur differentes : 

//Exemple 1 

var i:Number=5; // Initialisation du compteur de boucle a 5 
do { 

traceC'Ce texte est affiche au moins une fois <br>"); 
--i; // Decrementation du compteur de boucle 
} while(i>0) 

/* Ci-dessus un exemple qui affiche cinq fois le meme texte (tant que $i est superieur a 0) 

*»avant d'afficher le texte final. */ 
// 

//Exemple 2 

var i:Number=0; // Initialisation du compteur de boucle a 0 
do { 

traceC'Ce texte est affiche au moins une fois <br>"); 
--i; // Decrementation du compteur de boucle 
} while(i>0) 

/* Ci-dessus un exemple qui affiche le texte une seule fois car l'expression de condition est 
*»fausse des le premier tour. */ 



Structures de boucle avec for 

L'instruction for est une troisieme solution pour traiter les boucles. Sa syntaxe est cependant plus 
compacte que la structure avec while, car tous les parametres de la boucle sont regroupes entre les 
parentheses de 1' instruction. En une seule ligne, il est possible d' initialiser le compteur de boucle, de 
definir la condition de boucle et de configurer 1' incrementation (ou la decrementation) qui aura lieu 
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automatiquement a chaque tour de boucle. Ces trois parametres sont integres dans les parentheses et 
separes par des points-virgules. 



A noter 

Dans le cas de boucles imbriquees, cette syntaxe tres compacte est particulierement appreciable quant a la lisi- 
bilite du code. 



Tableau 10-11. Instruction de boucle for 

Syntaxe 

for (expressionl[ ,...] ;expression2[ ....] ;expression3[ ,...] ) 
{ 

instruction!.; 
instruction?; 

) 

Legende expressionl : expression evaluee en debut de boucle. Frequemment utilisee pour initialiser lecompteur de boucle 
a I'aide de I'operateur d'affectation (exemple : var i:Number= 5). 

expression2 : expression evaluee au debut de chaque passage de boucle. Si le resultat de revaluation est true 
(vrai), le bloc d'instructions de la boucle est de nouveau execute. Dans le cas contraire, le programme sort de la 
boucle pour executer les instructions qui suivent le bloc. Cette expression est frequemment utilisee pour tester le 
compteur de boucle a I'aide d'un operateur de comparaison (exemple : i > 0). 

expressions : expression evaluee a la fin de chaque boucle. Frequemment utilisee pour incrementer ou 
decrementer le compteur de boucle a I'aide d'un operateur d'auto-incrementation ou de decrementation 
(exemple : --1 ou++i). 
[xxx] : le code xxx est facultatif 

(Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 

L' exemple ci-dessous realise la meme boucle que celle de F exemple presente precedemment avec la 
structure whi 1 e mais exploitant cette fois une structure for : 

for (var i :Number=5;i>0; --i) 
f 

trace( "Encore"+i+" tour(s) a faire "); 

} 

trace( "Voi 1 a , c'est enfin termine"); 

Exemple 2 (cet exemple realise la meme duplication de clip que celle de F exemple presente prece- 
demment avec la structure whi 1 e avec une structure for) : 

for(var i :Number=0;i<=4;++i ) { 

monCl ipjnc.dupl icateMovieCl ip( "monCl ip"+i+"_mc" , i ) ; 
_root["clip"+i+"_mc"] ._x=100+i*10; 
_root["clip"+i+"_mc"] ._y=100+i*10; 
} 
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Structures de boucle avec for ... in 

La structure for ... in permet d'acceder aux noms et aux valeurs des differentes proprietes d'un 
objet. En effet, chaque propriete d'un objet est stockee dans un tableau associatif (dont les cles 
sont les noms des proprietes de l'objet). A l'aide de la boucle for ... i n, il est possible de parcou- 
rir toutes les proprietes d'un objet et de recuperer du meme coup leur valeur. Ce type de structure 
peut etre exploite pour connaitre le nom et la valeur d'un objet de scenario ou encore d'un objet 
XML. 

Tableau 10-12. Instruction de boucle for ... in 

Syntaxe 

for (cle_propriete in nom_objet) 
{ 

.... nom_objet[poi nteur_propri ete] ; 

| } 

Legende cle_propriete : declaration de la cle des proprietes de l'objet (exemple : var p:String= 5). 
nom_objet : nom de l'objet. 

nom_objet[cl e_propriete ] : permet d'acceder aux valeurs des proprietes de l'objet dans le corps de boucle. 




Prenons comme exemple un objet appartement auquel on ajoute trois proprietes : surface, etage et 
prix : 

var appartement:Object=new ObjectO; 

appartement. surf ace=150; 

appartement. etage=4; 

appartement . prix=80000 ; 

// 

fortvar p:String in appartement) { 
trace(p+" = "+appartement[p] ) ; 

} 

Si nous ajoutons ensuite une structure for ... in configuree avec le nom de cet objet, le texte suivant 
est affiche dans le panneau Sortie : 

prix = 80000 
etage = 4 
surface = 150 



Instructions de controle 

Instruction de controle avec break 



Dans certaines applications, il peut etre necessaire de sortir de la boucle avant que 1' expression de 
condition ne l'impose (c'est valable pour toutes les stuctures : whi 1 e, do ... whi 1 e, for et swi tch ... case). 
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Dans ce cas, utilisez l'instruction break pour quitter la structure de boucle et pour que le programme 
passe a l'execution des instructions qui se trouvent apres celle-ci. 



A noter 

Cette instruction est obligatoire dans les structures switch ... case afin d'eviter d'executer les instructions qui 
suivent la branche du case selectionne. 



Tableau 10-13. Instruction de controle de boucle break 



Syntaxe 

break ; 



L'exemple ci-dessous presente une structure de boucle dans laquelle on a ajoute une instmction break 
conditionnee par une structure de choix (if(interrupteur>2). A chaque tour de boucle, la variable 
interrupteur est incrementee jusqu'au moment ou sa valeur est superieure a 2. A ce moment, 
l'expression de condition renvoie true, l'instruction break est executee et le programme sort prema- 
turement de la boucle : 

var i :Number=6; // Initialisation du compteur de boucle 

var interrupteur:Number=0; // Initialisation de la variable de la structure de choix 
whi 1 e( i >0 ) 
f 

if (interrupteur>2) break; // Arrete la boucle si interrupteur est > 3 
trace( "Encore "+i+ "tour(s) a faire "); 
i--; // Decrementation du compteur de boucle 
interrupteur++; // Incremente 1 'interrupteur 

} 

trace( "Voi 1 a , c'est enfin termine"); 
Apres l'execution de ce script, le message suivant est affiche dans le panneau Sortie : 

Encore 6 tour(s) a faire 

Encore 5 tour(s) a faire 

Encore 4 tour(s) a fai re 

Voi IS, c'est enfin termine 

Instruction de controle avec continue 

L'instruction continue est egalement une instruction de controle de boucle, mais, contrairement a 
Taction break, elle permet seulement d'interrompre la boucle en cours et de passer au tour de boucle 
suivant. 
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Tableau 10-14. Instruction de controle de boucle continue 



Syntaxe 

continue 



Dans l'exemple ci-dessous, une instruction continue est conditionnee par une structure de choix 
(i f ( i ==t )), elle-meme inseree dans le corps d'une boucle for. Ainsi, la structure de choix et Finstruction 
conti nue permettent de court-circuiter le tour de boucle pour lequel le compteur i =2 : 

for(var i :Number=4;i>0;i--) 

{ 

if (i==2)continue; // Court-circuite le tour de boucle lorsque i est egal a 2 

trace( "Encore "+i+" tour(s) a faire "); 

} 

traceCVoila, c'est enfin termine"); 

Apres Fexecution de ce script, le message ci-dessous est affiche dans le panneau Sortie : 

Encore 4 tour(s) a faire 
Encore 3 tour(s) a faire 
Encore 1 tour(s) a faire 
Voila, c'est enfin termine 
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Interfacage Flash-PHP-Txt 



Utiliser une interface Flash en interaction avec des scripts PHP permet de realiser de nombreuses 
applications qui exploitent a la fois la convivialite des animations Flash et la puissance des scripts 
PHP. Ce premier type d'interfacage permet d'envoyer et de charger des donnees dans un simple 
fichier texte via un script PHP adapte. Par la suite, toujours par F intermediate de scripts PHP, nous 
aborderons Finterfacage Flash-PHP-MySQL qui relie une application Flash avec les donnees d'une 
base MySQL afin de memoriser les informations d'une animation Flash en dehors des limites de la 
session d'un internaute ou de recuperer des informations complexes depuis une base de donnees 
MySQL (se reporter au chapitre 18). 

Pour illustrer le principe de ces echanges, nous allons vous presenter plusieurs modes d'interfacage 
Flash-PHP-Txt utilisant differentes fonctions Flash. 

Terminologie specifique aux sources de donnees 

Source de donnees 

Dans Flash, on appelle source de donnees la localisation d'un ensemble de donnees externes qui 
pourront etre chargees puis exploitees dans 1' animation Flash. Une source de donnees peut etre un 
simple fichier texte, un fichier XML ou encore la resultante de F execution d'un script PHP mettant au 
format d'URL des donnees issues d'une base de donnees. Pour que ces sources de donnees puissent 
etre exploitees au sein d'une application Flash, elles doivent etre formatees selon leur type et Fobjet 
Flash qui aura en charge de les recuperer (par exemple, un fichier texte gere par la classe 1 oadVars ou 
encore un fichier XML gere par la classe XML. . .). 
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Transfert de donnees : chargement et envoi 

On appelle transfert de donnees Taction de transferer les valeurs d'un ensemble de donnees 
d'une entite a l'autre. II peut etre effectue depuis une source de donnees externe (informations 
au format texte ou XML memorisees dans un fichier ou generees dynamiquement) vers une 
animation Flash (on parle alors de chargement). II peut egalement etre effectue depuis 1' anima- 
tion Flash vers une autre application (un script serveur par exemple ; on parle alors d' envoi de 
donnees). 

Interfagage entre deux applications 

On appelle interfacage un systeme assurant le transfert bidirectionnel des donnees entre deux entites 
(envoi et chargement). Ainsi, il peut y avoir des interfacages entre une animation Flash et une appli- 
cation serveur (script PHP, par exemple), entre une animation Flash et une base de donnees MySQL 
(via un script PHP) ou encore entre une animation Flash et une structure XML. Selon les cas, ces 
interfacages pourront etre plus ou moins complexes. 

Complements techniques concernant les transferts de donnees 

L'encodage UTF-8 

LUTF-8 est un type d'encodage utilise par Unicode qui permet de gerer des flux de donnees quelle 
que soit la langue utilisee, ce qui evite les problemes d' interpretation des accents ou autres caracteres 
speciaux specifiques a chaque langue. Ce type d'encodage est utilise par defaut dans les animations 
Flash. L'encodage usuel des donnees en langue francaise etant l'ISO-8859-1 (jeu de caracteres 
Europe occidentale, Latin-1), il est souvent necessaire de decoder (ou d'encoder) les donnees 
echangees avec une animation Flash. 

Selon l'origine de la source de donnees, voici les actions a effectuer afin d'obtenir des donnees au 
format UTF-8 : 

• Pour les donnees issues d'un fichier cree par un editeur, il suffit d'enregistrer les fichiers texte (.txt) 
ou XML (.xml) en selectionnant le format UTF-8 (Unicode). Les fichiers XML devront en outre 
commencer par une balise specifiant l'encodage utilise : 

| <?xml version="1.0" encoding="UTF-8" ?> 

• Pour les fichiers generes par un script PHP, il faut utiliser la fonction utf8_encode( ). Si ces donnees 
sont transmises par FURL (methode GET), il faut en outre utiliser la fonction url encode( ) comme 
dans F exemple ci-dessous : 

echo "maDonnee=" . url encode(utf8_encode($maChaineIso) ) ; 
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Fonctions PHP pour I'encodage et le decodage UTF-8 



Tableau 11-1. Syntaxe de la fonction utf8_encode() 

utf8_encode( ) 

Gene Toncnon mmm converw une cname lSO-bbby-l en u l h-b 
Syntaxe ae la Toncnon : 
utf8_encode(nomDeLaChaine_IS0) ; 
bxempie : 

$maVari abl e=utf8_encode($chaineIso) ; 

Dans cet exemple, la chaine $chaineIsoest decodee en UTF-8 et enregistree dans la variable $maVari able avant d'etre 
envoyee a 1'animation Flash. 



Tableau 1 1 -2. Syntaxe de la fonction utf8_decode() 

utf8_decode( ) 

Gene toncnon mmm convertit une cname u I h-b en iSG-bbby-i 
Syntaxe de la toncnon : 
utf8_decode(nomDeLaChaine_UTF8) ; 
bxempie : 

$maVari abl e=utf8_decode($chai neUtf8) ; 

Dans cet exemple, la chaine $chat neUtf8 (issue, par exemple, d'un formulaire Flash) est decodee en ISO-8859-1 et enregistree 
ensuite dans la variable $maVari abl e. 



Fonctions AS pour la gestion de I'encodage 

Tableau 11-3. Syntaxe de la fonction useCodePage() 

■ 

System. useCodePage 

Si vous affectez la valeur vrai (true) a ce parametre dans la premiere image cle de votre scenario principal, le format des donnees 
ne sera plus le format par defaut UTF-8 mais l'ISO-8859-1 . 

Si I'utilisation de l'UTF-8 est impossible dans votre application, vous pourrezquand memegerer des donnees importees au format 
ISO-8859-1 dans votre animation Flash en ajoutant cette instruction. 

Syntaxe de I'affectation de ce parametre : 
System. us eCodePage=t rue; 



Les methodes GETet POST 

Pour echanger des donnees entre une application client (une animation Flash ou un simple formulaire 
HTML) et une application serveur (un script PHP, par exemple), il faut utiliser des methodes HTTP pour 
transferer les couples variable/valeur a F application serveur afin qu'ils soient traites. Deux techniques 
differentes peuvent etre utilisees : la methode GET ou la methode POST. 

La methode GET 

Si vous utilisez la methode GET, les couples variable/valeur seront ajoutes dans l'URL a la suite du 
nom du fichier cible selon une syntaxe specifique (format d'URL). Si vous envoyez a un script af f i - 
che.php deux champs nommes nom et message depuis un formulaire HTML (ou depuis une animation 
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Flash) en utilisant la methode GET, vous verrez apparaitre FURL suivante dans la zone d'adresse du 
navigateur : 

af f iche.php?norri=toto&rriessage=bonjour 

Le fait que toutes les donnees soient visibles dans l'URL empeche d'utiliser cette methode pour 
envoyer des informations confidentielles. D'autre part, le nombre de donnees envoyees avec la 
methode GET est limite a 255 caracteres, ce qui represente une seconde contrainte. Cependant, 
la methode GET peut etre facilement construite a l'aide d'un script PHP, ce qui est un avantage (revoir 
les instructions de concatenation de PHP). En outre, FURL de sa requete peut etre memorisee dans 
vos favoris (ce qui n'est pas le cas avec la methode POST). 

Tableau 11-4. Syntaxe de la methode GET 

Methode get 

Methode HTTP d'envoi de donnees dans l'URL 
Syntaxe de la fonction : 

NomDuFichierCible.plip?noinVarl=valeurl& nomVar2=val eur2& nomVar3=val eur3 

Legende : Le signe ? place apres le nom du fichier cible introduit les couples variable/valeur. Dans les couples variable/valeur, 
la valeur est reliee a la variable par un signe =. Si plusieurs couples doivent etre transmis, le separateur & est utilise entre chaque 
couple. 

Remarque : L'utilisation de la methode GET est tres simple. Cependant, les donnees transmises sont visibles aux yeux de tous 
dans l'URL et le nombre de caracteres est limite a 255. 



Script serveur PHP 



Formulaire HTML 


affiche.php 






$_GET['nom'] 


nom : 


Dupond 


= Dupond 








message : 


Bonjour 


$_GET['message'] 






= Bonjour 


methode GET 








► 



affiche.php?nom=Dupond&message=Bonjour 



Figure 11-1 

Envoi de donnees a l'aide de la methode GET 

Les donnees transmises a un script PHP par la methode GET sont ensuite disponibles depuis un 
tableau $_GET[ ]. Si nous reprenons Fexemple precedent, les valeurs des variables nom et message 
pourront etre recuperees en utilisant les elements de tableau $_GET[ 'nom' ] et $_GET[ 'message']. 
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La methode POST 

Si vous utilisez la methode POST, les couples variable/valeur sont regroupes dans Fen-tete de la 
requete HTTP. Si vous envoyez a un script affiche.php deux champs nommes nom et message depuis 
un formulaire HTML (ou depuis une animation Flash) en utilisant la methode POST, rien n'apparait 
dans FURL puisque les donnees sont envoyees dans Fen-tete de la requete. Cette methode preserve 
vos donnees des regards indiscrets et n'est pas limitee a 255 caracteres. 



Figure 11-2 

Envoi de donnees d Vaide 
de la methode POST 



Formulaire HTML 



nom : Dupond 



message : Bonjour 



methode POST 



Script serveur PHP 
affiche.php 



affiche.php 



$_POST['nom'] 
= Dupond 

$_POST['message'] 
= Bonjour 



nom=Dupond 
message=Bonjour 



Les donnees transmises a un script PHP par la methode POST sont ensuite disponibles depuis un 
tableau $_P0ST[ ]. Si nous reprenons Fexemple precedent, les valeurs des variables nom et message 
pourront etre recuperees en utilisant les elements de tableau $_P0ST[ 'nom' ] et $_P0ST[ 'message' ]. 



Fonctions PHP pour le transfert des donnees 

Tableau 11-5. Syntaxe de la fonction urlencodeQ 



url encode( ) 

Cette fonction PHP retourne une chaine dont laquelle les caracteres speciaux (les lettre accentuees, les guillemets ou encore 
les caracteres < et >, par exemple) sont remplaces par une sequence commencant par un caractere % suivi de deux chiffres 
hexadecimaux. Si la chaine comporte des espaces, ils seront remplaces par des signes +. 

Syntaxe de la fonction : 

url encode (nomDetaChai re) ; 

Exemple : 

$chai ne="Bonjour a tous"; 

echo '<a href="maPage.php?maVariable=' .urlencode($chaine) . ' ">clic ICK/a>'; 

Dans cet exemple, la chaine envoyee en parametre dans I'URL sera codee de la maniere suivante (le caractere a est remplace 
par %E0 et des signes + sont ajoutes pour lier les mots entre eux) : 
maVariabl e=Bonjour+%EO+tous 
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Tableau 11-6. Syntaxe de la fonction urldecodeQ 


urldecode() 

Opttp fnnrtinn PHP riprnrlp Ip<; ^Pnupnrpt; ri'l IRI ^au format %,yy^ pt Ip<? rpmnlanp nar Ipiit valpur rl'nrininp 

vCUC \\J\ \\ji\\J\ I 1 1 II U^uVuC ICO OCUUCI IV_*C O U Ul 1 1 lull 1 \J\ 1 1 1 Q I ■ 0 A A J CI ICO 1 CI 1 1 UluOC Uul IUUI V QIC U 1 \J \J\ iy 1 1 IC . 

Syntaxe de la fonction : 

url decode (nomDeLaChalne) ; 





Exemple : 




$chaine=" Bonjour+^EO+tous" ; 




echo urldecode($chaine) ; 




Dans cet exemple, la chaine est decodee et affiche le texte suivant : 




Bonjour a tous 





Les problemes de cache 

Dans vos futures applications Flash dynamiques, vous serez certainement confronte a des problemes lies 
au cache du navigateur (surtout avec IE) ou aux serveurs proxy-cache. En effet, des qu'un fichier (simple 
fichier texte, fichier XML ou fichier genere par un script PHP) est charge dans une animation Flash, 
il est egalement copie dans le cache du navigateur (ou dans des serveurs proxy-cache selon la configu- 
ration de votre reseau). Si vous rappelez cette ressource et que les donnees contenues dans le fichier 
ont ete modifiees, vous risquez de ne pas voir ces modifications apparaitre dans votre application Flash. 

Pour resoudre ce probleme, il existe plusieurs solutions. 
Ajouter des balises meta dans la page HTML 

Vous pouvez ajouter des balises meta dans Fen-tete de vos pages HTML pour indiquer au navigateur 
de ne pas stocker vos pages dans les repertoires caches comme il le fait habituellement pour optimiser 
Faffichage des pages Web : 

<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=i so-8859-1" /> 

<meta HTTP-EQUIV="expi res" content="0"> 

<meta HTTP-EQUIV="Pragma" content="no-cache"> 

<meta http-equiv="Cache-Control " content="no-cache" /> 

<title>compteur</title> 

</head> 

La premiere ligne a ajouter dans la balise head (en gras) met a 0 la valeur expi res (cette balise META 
permet d'indiquer une date de peremption pour la page HTML. Les navigateurs ne doivent pas 
conserver cette page dans leur cache au-dela de la periode d'expiration, soit 0 dans notre cas). 
Les deux autres lignes interdisent la mise en cache dans le navigateur (pour HTTP 1.0 et HTTP 1.1). 

Ajouter des header dans vos pages PHP 

Si vos donnees sont generees par des scripts PHP, vous pouvez creer une en-tete a Faide de F instruction 
header( ) afin de bloquer la mise en cache des informations de la page comme dans le script ci-dessous 
(Attention ! Ce script doit etre place au debut de la page PHP) : 



// Blocage du Cache 

headerC'Expires: Mon, 12 Jul 1995 02:00:00 GMT"): 
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II Date d'expiration anterieure a la date actuelle 

headerC'Last-Modified: " . gmdateC'D, d M Y H:i:s") . " GMT"); 

// Indique de toujours modifier la date 

header( "Cache-Control : no-cache, must-reval idate" ) ; 

// no-cache pour HTTP/1.1 

headerC'Pragma: no-cache"); 

// no-cache pour HTTP/1.0 

Nous vous recommandons de placer ces lignes de code dans un flchier externe et de l'appeler au 
debut de chaque flchier PHP. Par exemple, si vous enregistrez ces lignes de code dans un flchier 
nomme blocageCache.php (n'oubliez pas de placer les balises PHP au debut et a la fin du flchier), 
utilisez l'instruction suivante pour Finclure dans chaque flchier PHP : 

requi re_once( 'bl ocageCache.php' ) ; 

Utiliser une variable aleatoire dans Flash 

Une autre solution consiste a ajouter une variable aleatoire a la fin du nom de flchier appele par une 
methode LoadVariables, LoadVari abl esNum ou laclasse LoadVars. La valeur de la variable etant diffe- 
rente a chaque appel, cela force le navigateur, qui croit qu'il s'agit d'un flchier different, a recuperer 
la nouvelle version du flchier. 



A noter 

Dans notre exemple, nous avons utilise maVar comme nom de variable aleatoire, mais vous pouvez utiliser le nom 
de votre choix, cela n'a aucune importance. D'autre part, vous ne pourrez pas tester ce systeme depuis I'environ- 
nement test de Flash, car la variable aleatoire est passee dans I'URL. II est done imperatif de publier votre animation et 
de l'appeler ensuite depuis le WebLocal. 

// Exemple avec la methode LoadVari abl esNum 

LoadVari abl esNum( "monFichier .php?maVar="+GetTimer( ) ,2) ; 

// Exemple avec la classe LoadVars 

monObjet_lv = new LoadVarsO; 

monObjet_l v. 1 oad( "monFichier .php?maVar="+GetTimer( ) ) ; 



Restriction d'acces aux donnees d'un autre domaine 

Depuis Flash 7, la restriction de securite concernant l'usage de sources de donnees situees sur un 
domaine different de celui de l'animation est renforcee. En effet, avec Flash 6, toutes les sources de 
donnees situees dans le meme superdomaine que le flchier SWF pouvaient etre exploiters. Si le 
domaine du flchier SWF etait www.eyrolles.com, le chargement des donnees pouvait etre realise 
depuis une source de donnees placee dans des domaines ftp.eyrolles.com ou data.eyrolles.com. 
Depuis la version 7 de Flash Player, les domaines doivent etre strictement identiques et seules des 
donnees situees dans les domaines www . ey rol 1 es . com pourront desormais etre chargees par le SWF. 

II existe heureusement des solutions pour contourner cette restriction. La premiere consiste a confi- 
gurer un flchier crossdomai n a la racine du domaine fournissant les donnees. 

La seconde solution s'appuie sur une astuce qui consiste a Conner la recuperation des donnees a un 
flchier PHP (les fichiers PHP n'ayant pas de contrainte de securite de ce type). 
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Le fichier crossdomain 

II est possible d'obtenir une autorisation pour utiliser des donnees d'un autre domaine d'acces grace 
a un fichier crossdomain. xml place a la racine du domaine fournissant les donnees. Votre domaine 
doit figurer dans ce fichier de regulation si vous desirez acceder aux donnees. 

Exemple de fichier crossdomain. xml autorisant les deux domaines www.phpmx.com et www.agencew.com 
a exploiter les donnees situees dans le domaine ou a ete place ce fichier : 

<cross-domain-pol icy> 

<al 1 ow-access-form-domain= "www. phpmx.com" /> 

<al low-access -form-domain= "www. agencew. com" /> 
</cross-domain-pol icy> 



A noter 

Si vous desirez mettre vos donnees a la disposition de tous les domaines (et done sans aucune restriction), utilisez 
le caractere * a la place du nom de domaine, comme dans le fichier crossdomaine.xml ci-dessous : 

<cross-domain-pol icy> 

<al 1 ow-access-form-domain="*" /> 
</cross-domai n-pol icy> 



Connexion a un site distant a I'aide d'un fichier PHP 

Voici une seconde solution qui vous permettra d' acceder a des fichiers de donnees distants situes sur 
un autre domaine. Le principe consiste a ne pas acceder aux donnees directement avec Flash mais de 
Conner la recuperation des donnees a un fichier PHP. 

Dans un premier temps, Fadresse du fichier de donnees sera envoyee par le Flash a ce fichier PHP 
que nous nommerons liaison. php dans notre exemple. Ensuite, le fichier PHP recuperera les donnees 
du domaine externe puis les renverra au Flash pour les exploiter. 

Dans notre exemple, le fichier de donnees info.txt se trouve a la racine du domaine www.dinera- 
paris.com (notez que si le fichier de donnees etait un fichier XML la demarche serait identique). 
Le fichier Flash qui desire exploiter les donnees se nomme af f i che . swf et le fichier PHP qui assure 
la recuperation des donnees s'appelle 1 i ai son . php. 

Le fichier Flash affiche.swf doit comporter un premier objet LoadVars, qui servira a envoyer 
Fadresse du fichier de donnees arecuperer, et un second objet LoadVars, qui servira a la reception des 
donnees envoyees par le fichier PHP. Dans notre exemple, la recuperation des donnees est declenchee 
par un bouton boutonl_btn place sur la scene. 

affiche.fla 

var envoi_l v : LoadVars=new LoadVarsO; 

var reception_lv:LoadVars=new LoadVarsO; 

boutonl_btn.onRelease = functionO { 

envoi_l v. adresse=" http://www.di neraparis.com/ info.txt" ; 

reception_l v. on Load=f unction (success) { 

if(success) { 

_root . i nf ol= recepti on_l v . i nf ol ; 
_root . i nf o2= recepti on_l v . i nf o2 ; 
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II Traitement des donnees recuperees... 
} 
) 
} 

envoi_l v.senAndAndLoad( "1 iaison.php" , reception_l v .POST) ; 

Le fichier PHP 1 i ai son . php doit commencer par recuperer l'adresse du fichier de donnees. Ensuite, il 
accede aux donnees et les memorise dans une variable Sdonnees. Enfin, il les renvoie au fichier Flash 
grace a une simple instruction echoO. Notez que le fichier de donnees de notre exemple infos.txt 
contient deux donnees, i nf ol et i nf o2, deja formatees pour etre envoyees et interpretees par le fichier 
Flash. 

liaison. php 
<?php 

// Recuperation de l'adresse du fichier de donnees envoye par le Flash 
if(isset($_POST['adresse'])) $adresse=utf8_decode($_P0ST['adresse']) 
// Recuperation des donnees du fichier distant 
$f ichier=f open (Sad resse, "r+" ) ; 
$donnees=fgets($fichier,10) ; 
fclose($fichier) ; 

// Formatage et envoi des donnees a Flash 
Sdonnees = utf8_encode($donnees) ; 
echo Sdonnees; 
?> 

infos .txt 

&infol=5555&info2= 



Envoi de donnees de Flash vers PHP avec GetURL 

Initialement, la methode GetURL ( ) est destinee a appeler une URL (une URL est un chemin absolu ou 
relatif qui permet de localiser une ressource) depuis une animation Flash. Cette methode permet aussi 
de transmettre des donnees depuis Flash vers un script PHP d'une maniere unidirectionnelle. 

Lorsqu'on utilise GetURL, les informations sont envoyees avec la methode GET (passage de variables 
dans l'URL) ou POST (passage de variables dans l'en-tete HTTP). Les variables transmises par Fune 
de ces deux methodes sont disponibles dans le fichier PHP comme des variables envoyees par un 
formulaire HTML traditionnel (les valeurs recuperees sont stockees dans un tableau $_GET[nomVar] 
ou $_POST[nomVar] selon la methode employee). 



Tableau 11-7. Syntaxe de la methode getURL() 

getURLO 

Appelle un document cible par son URL puis le charge dans une fenetre specifique. Si la methode est precisee (parametre 
variables : GET ou POST), les variables de I'animation seront transmises au document cible. 

Syntaxe de la methode : 

getURLC'url" [, "fenetre" [, "variables"] ]) 
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Tableau 11-7. Syntaxe de la methode getURL() (suite) 



Legende 



url : URL absolue ou relative du document cible. 



fenetre : parametre facultatif qui permet de preciser la fenetre ou le cadre HTML dans lequel doit s'ouvrir le 

document cible. II est possible d'indiquer le nom d'une fenetre specifique ou Tune des options suivantes : 

_sel f : pour indiquer la fenetre courante 

_bl ank : pour indiquer une nouvelle fenetre 

_pa rent : pour indiquer le parent de la fenetre courante. 

_top : pour indiquer le premier niveau par rapport a la fenetre courante. 

variables : permet de specifier la methode HTTP utilisee (GET ou POST). Si ce parametre n'est pas precise, 
aucune variable ne sera transmise au document cible. 
[xxx] : le code xxx est facultatif. 

(Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 



Pour illustrer l'echange de donnees depuis Flash vers un script PHP avec la fonction getURL( ), nous 
vous proposons de creer un petit formulaire dans une animation Flash (f ormul ai re . f 1 a) et un fichier 
PHP (af f i che . php) qui permet d'afficher les variables envoyees par le formulaire Flash. 

Une zone texte portant le nom de variable message est creee dans l'interface Flash. La valeur saisie 
dans ce champ est ensuite transmise a un fichier PHP, dans lequel on recupere l'information dans une 
variable nommee $message. 

Le document Flash 

1. Creez un nouveau document Flash et sauvegardez-le sous le nom formul ai re . f 1 a dans un sous- 
repertoire du dossier www/SITEf 1 ash/ de votre serveur local. Pour classer les differents scripts de 
cet ouvrage, nous avons enregistre le document Flash dans le repertoire SITEflash/3-progStruc- 
turee/chapll/transfertGetUrl / mais vous pouvez utiliser tout autre repertoire de votre choix 
dans la mesure ou il se trouve dans le dossier www/SITEf 1 ash/. 

2. Creez quatre caiques : Fond, Message, Bouton et Action. 

3. Personnalisez le caique Fond (texte d' information, couleur de fond. . .). 

4. Ajoutez une zone de texte sur le caique Message. Selectionnez le type Texte de saisie et saisissez 
le nom message dans le champ Var (voir figure 11-3). 

5. Creez un symbole de type bouton (envoi J3tn) puis placez une occurrence nommee envoi l_btn 
sur le caique Bouton (voir figure 1 1-4). 

6. Saisissez ensuite le script suivant dans l'image cle 1 du scenario principal (voir figure 11-5). 
Dans ce script, le premier parametre de la methode getURK ) indique que le fichier cible se trouve 
dans le meme repertoire que F animation et se nomme affiche.php. Le deuxieme parametre 
precise que le fichier devra s'ouvrir dans une nouvelle fenetre (option _bl ank). Enfin, le troisieme 
parametre specifie que la methode POST sera utilisee pour le transfert des donnees : 



boutonl_btn.onRelease=function( ) { 

getURL( "affiche.php" , "_bl ank" , "POST" ) ; 
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Figure 11-3 

Creation de la zone texte nominee message qui servira a la saisie du message envoye an script PHP 
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Figure 11-4 

Creation du bouton a" envoi du message. L' occurrence de ce bouton doit etre nommee envoi! _btn. 
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Figure 11-5 

Script de gestion du bouton 



7. Enregistrez votre fichier et publiez-le dans une page HTML sous le meme nom que la source, soit 
formulaire.htm. 



Le document PHP 

Cote PHP, le script est tres simple puisqu'il contient uniquement un test destine a s'assurer de l'exis- 
tence de la variable $message, suivi d'une instruction echo qui affiche la valeur de cette derniere. 

1 . Creez un nouveau document PHP (Fichier>Nouveau>Page dynamique>PHP) et sauvegardez-le 
sous le nom af f i che . php dans le meme repertoire que le document Flash. 

2. Passez en mode Code et saisissez le script ci-dessous dans la fenetre du document (voir figure 11-6). 

<? 

// Initialisation des variables 

if (!isset($_POST['message'])) $_P0ST[ 'message ']="" ; 
el se 

{ 

$message=utf8_decode($„P0ST[ 'message' ] ) ; 

echo "Vous avez un message : <br><hl> " . Smessage. "</hl>" ; 

// Affichage de la variable "Smessage" a l'ecran 

} 

?> 

3. Enregistrez le document PHP (Ctrl + S). 
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Figure 11-6 

Le code PHP ci-dessus permet d'afficher le message envoy e par le formulaire Flash dans une nouvelle fenetre 
du navigateur. 



Test dans le WebLocal 

Pour le test, il suffit d'appeler le fichier formulaire.htm depuis votre Web local (selectionnez l'option 
local host depuis le menu du manager de Wamp. Cliquez ensuite successivement sur les differents 
dossiers afin d'afficher le fichier formulaire.htm). Une fois le formulaire affiche a l'ecran, saisissez 
un texte dans la zone message et cliquez sur le bouton OK. Le message doit alors s'afficher dans une 
nouvelle fenetre (voir figure 11-7). 
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Figure 11-7 

Test de 1' envoi de donnees de Flash vers PHP avec lafonction getURL(). 
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Chargement d un fichier texte avec loadVariables() 
ou loadVariablesNum() 

Ces deux methodes se differencient principalement par 1' element dans lequel les donnees seront 
chargees. Pour loadVariablesO, il s'agit d'un clip (identifie par son nom d'occurrence) alors que 
pour loadVariablesNumC ), il s'agit d'un niveau (identifie par son numero, exemple : 2 pour _level 2), 
d'ou la presence du suffixe Num. 



Tableau 11-8. Syntaxe de la methode loadVariablesO 



1 oadVariables( ) 


Charge les variables d'une source de donnees externe (simple fichier texte ou texte genere par un script PHP) et definit les varia- 
bles en rapport dans le clip cible. 


Syntaxe de la methode : 

1 oadVari abl es( "url " , "occurrence" [, "variables"] ) 


Legende 


url : URL absolue ou relative de la source de donnees (fichier texte ou script PHP generant dynamiquement 
les variables). 

occurrence : chemin cible de I'occurrence du clip qui recevra les variables. 

variables : permet de specifier la methode HTTP utilisee (GET ou POST). Si aucune variable ne doit etre 
envoyee depuis I'animation Flash, ce parametre peut etre omis. 
[xxx] : le code xxx est facultatif. 

(Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 


Remarques 


Les noms des variables des champs de texte du document Flash doivent correspondre aux noms des variables 
de la source de donnees. 

LURL de la source de donnees doit etre du meme domaine que le fichier SWF lorsque I'acces se fait par un 
navigateur Web. Pour plus d'information sur ces restrictions, consultez la partie concernant le fichier cross- 
domain au debut de ce chapitre. 


Exemples 


loadVariablesCdata.txt" , "_root.monCl ip_mc" ) 

Chargement d'un simple fichier texte data . txt dans le clip monCl i p_mc place sur le scenario principal. 
loadVariablesCprocess/chargeur.php" , "_root.monCl ip_mc" , "GET") 
Chargement dans un clip monCl ip_mc d'une source de donnees generee dynamiquement par le script char- 
geur.php (place dans le repertoire processeur) ettransfert detoutes les variables du clip vers le meme script 
en methode GET. 



Tableau 11-9. Syntaxe de la methode loadVariablesNum() 

loadVan'ablesNunU ) 

Charge les variables d'une source de donnees externe (simple fichier texte ou texte genere par un script PHP) et definit les varia- 
bles en rapport dans le niveau cible. 

Syntaxe de la methode : 

loadVan'ables("url " , niveau [, "variables"] ) 
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Tableau 11-9. Syntaxe de la methode loadVariablesNum() (suite) 



Legende 



Remarques 



Exemples 



url : URLabsolue ou relative de la source de donnees (fichier texte ou script PHP generant dynamiquement 
les variables). 

niveau : numero du niveau qui recevra les variables (par exemple : 2 pour le _level 2). 

variables : permet de specifier la methode HTTP utilisee (GET ou POST). Si aucune variable ne doit etre 

envoyee depuis I'animation Flash, ce parametre peut etre omis. 

[xxx] : le code xxx est facultatif. 

(Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 

Les noms des variables des champs de texte du document Flash doivent correspondre aux noms des varia- 
bles de la source de donnees. 

L'UPiL de la source de donnees doit etre du meme domaine que le fichier SWF lorsque I'acces se fait par un 
navigateur Web. Pour plus d'information sur ces restrictions, consultez la partie concernant le fichier cross- 
domain au debut de ce chapitre. 

loadVariabl esNum( "http: //www.eyrol 1 es . com/chargeur .php" , 0) 

Chargementd'une source de donnees generee dynamiquement par un script chargeur .php place a la racine 
du site www.eyrol 1 es .com dans le scenario principal de I'animation (_level0). Rappel : Dans ce cas, I'ani- 
mation Flash doit elle aussi se trouver dans le domaine www.eyrol les .com. 
loadVariablesNumCchargeur.php" , 2 , "POST") 

Chargement dans le niveau 2 (_level2) de I'animation d'une source de donnees generee dynamiquement 
par I'appel du script chargeur .php. Le troisieme parametre (variables) etant specifie, toutes les variables du 
niveau concerne seront egalement envoyees au script chargeur. php par la methode POST. 



_root.nom1=Dupond 
root.tell =0145236585 



(_root) JevelO-^- 



&nom1=Dupond&tel1 =0145236585 



annuaire.txt 

loadVariablesNum( "annuaire.txt" , 0 ) 
I 



annuaire.swf 



Figure 11-8 

Utilisation de la methode loadVariablesNum pour charger un fichier texte dans une animation Flash 



Un annuaire Flash-Txt 

Pour illustrer le chargement d'un simple fichier texte dans une animation Flash avec la methode 
1 oadVari abl es( ), nous vous proposons de creer un petit annuaire telephonique. L'interface sera reali- 
see par une animation Flash (annuai re . f 1 a) qui affichera les donnees (nom et telephone des contacts) 
dans un champ texte. Les donnees utilisees seront issues d'un simple fichier texte (annuaire.txt) que 
nous realiserons au prealable. 
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Le fichier texte 

Avant de creer 1' animation Flash, nous allons definir la structure et les valeurs du fichier de donnees 
au format . txt. Les informations transmises pour chaque contact de Fannuaire sont composees d'une 
variable nom suivi d'un numero (exemple : noml) et d'une variable tel suivi du meme numero 
(exemple : tel 1). Pour illustrer le fonctionnement de F animation, nous saisirons dix contacts separes 
par un caractere & : 

noml=Dupond&tel l=0145235620&nom2=Vermont&tel 2=0145683689&... 

Apres cette suite de couples variables/valeurs constituant les donnees a exploiter dans Fannuaire, 
nous ajouterons deux autres variables. La premiere indique le nombre de contacts envoyes, soit dix 
dans notre exemple (nbre=10). La deuxieme cloture la chaine de donnees et sera testee dans Fanima- 
tion lors du chargement afin de s'assurer que toutes les variables ont bien ete chargees (fin=ok). 
La fin de la chaine de donnees ressemble a Fexemple ci-dessous : 

| ...&noml0=Bidaut&tell0=0459932204&nbre=10&fin=ok& 

Creation du fichier annuai re. txt avec Dreamweaver : 

1. Creez un nouveau document Texte a partir de Dreamweaver (menu Fichier>Nouveau>Categorie 
Autre>Texte). 

2. Saisissez les donnees selon Fexemple de la figure 1 1-9. 

3. Enregistrez le fichier au format texte sous le nom annuaire.txt dans un sous-repertoire du 
dossier www/SITEf 1 ash/ de votre serveur local (prendre par exemple le repertoire www/SITEf 1 ash/ 
3-progStructuree/chapll/l oadVariabl es/). 
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Figure 11-9 

Creation du fichier de donnees annuaire.txt avec Dreamweaver 
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Le document Flash 

1. Creez un nouveau document Flash et sauvegardez-le sous le nom annuaire.fla dans le meme 
sous-repertoire du dossier www/SITEflash/ que le fichier annuai re.txt. 

2. Creez six caiques : Fond, Chargement, Liste, Boutons, Action et Label. 

3. Personnalisez le caique Fond en ajoutant un cadre qui contiendra les elements de l'application et 
inserez une image cle dans l'image 17. 

4. Dans le caique Chargement, ajoutez un texte pour indiquer le chargement en cours. Inserez 
ensuite une image cle vide dans l'image 10. 

5. Dans le caique Liste, inserez une image cle dans l'image 10. Dans l'image 10, ajoutez sur la 
scene une zone de texte dynamique multiligne puis nommez son occurrence 1 i ste_txt. Saisissez 
le nom liste dans son champ variable. 

6. Dans le caique Boutons, inserez une image cle dans l'image 10. Dans l'image 10, ajoutez sur la 
scene deux boutons. Nommez-les hautl_btn et basl_btn. Us serviront a faire defiler les contacts 
dans le champ texte 1 i ste. 

7. Dans le caique Action, ajoutez l'instruction 1 oadVari abl esNum dans l'image cle 1 (voir figure 1 1-10). 
Le fichier annuaire.txt sera ainsi charge dans le niveau 0 de l'animation (les variables de la 
source de donnees seront disponibles depuis le scenario principal de l'animation). Vous remar- 
querez que la source de donnees etant un simple fichier texte, nous n'avons pas indique de 
methode (POST ou GET) afin que le chargement de donnees soit unidirectionnel et qu'aucune infor- 
mation ne transite de F animation Flash vers la source. 

Code de l'image cle 1 du caique Action : 

| 1 oadVari abl esNum( "annuai re. txt" ,0) ; 
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Figure 11-10 

Script de chargement integre dans l'image cle 1 du caique Action 
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8. Toujours dans le meme caique, inserez ensuite une image cle vide dans l'image 2 puis une image 
cle dans l'image 9. Dans l'image 9, saisissez le code du test controlant la fin du chargement des 
donnees (voir figure 11-11). Tant que la valeur de la derniere variable (fin="ok") ne sera pas 
disponible, l'animation bouclera sur l'etiquette Charge. Une fois toutes les donnees chargees, la 
tete de lecture de l'animation passera a l'etiquette Affiche. 

Code de l'image cle 9 du caique Action : 

if(_root.fin=="ok") { 

gotoAndStop( "Af f i che" ) ; 
}else { 

gotoAndPl ay ( "Charge" ) ; 

} 
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Figure 11-11 

Script de test de la fin du chargement integre dans l'image cle 9 du caique Action 



9. Inserez ensuite une image cle vide dans l'image 10 et saisissez dans cette meme image le 
code d'affectation des donnees a la variable 1 i ste ainsi que les deux scripts de gestion (utili- 
sant des methodes de gestionnaire d'evenements) des boutons de defilement du texte (voir 
figure 11-12). 

Code de l'image cle 10 du caique Action : 

7/ 

// Affectation des valeurs a la 1 i ste 
liste = ""; 

for (1=1; i<=_root.nbre; 1++) { 

liste += _root["nom"+i ]+"\t"+_root["tel "+i]+newline; 

1 
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I, 

// Gestion du bouton haut 
hautl_btn.onRelease = functionO { 
liste_txt. scroll -= 1; 

}; 

// 

// Gestion du bouton bas 
basl_btn.onRelease = functionO { 
liste_txt. scroll += 1; 

}; 




Figure 11-12 

Dans Vintage cle 10 du caique Action sont integres les scripts d 'affectation des donnees a la variable du champ texte 
(liste) et de gestion des boutons de defilement du texte (basl_btn et hautl _btn). 



10. Dans le caique Label, inserez une image cle vide dans l'image cle 2 et renseignez le champ Image 
du panneau des proprietes avec l'etiquette Charge. Inserez ensuite une autre image cle vide dans 
l'image 10 et indiquez cette fois l'etiquette Af f i che. 

1 1 . Enregistrez votre fichier, publiez vote animation dans une page HTML sous le meme nom que le 
source, soit annuaire.htm, et testez-la depuis un navigateur (voir figure 11-13). 



A noter 

Dans cet exemple, il n'est pas indispensable de tester I'application depuis le WebLocal puisque aucun fichier PHP 
n'est utilise. 
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Figure 11-13 

Test de Vannuaire 
dans un navigateur 
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Interfagage Flash-PHP avec loadVariables() ou loadVariablesNum() 

Dans l'exemple precedent, nous avons utilise la methode 1 oadVari abl esNum sans preciser de methode 
(POST ou GET). Par consequent, seules les donnees du fichier ont ete chargees dans Fanimation. 

Cependant, les methodes loadVariables et loadVariablesNum permettent aussi de transferer des 
donnees d'une maniere bidirectionnelle (de la source de donnees vers Flash et de Flash vers la source 
de donnees). II suffit pour cela de definir la methode a utiliser (GET ou POST) dans les parametres de la 
fonction. Evidemment, dans ce cas, la source du chargement ne peut etre un simple fichier texte car 
le meme document devra generer dynamiquement les informations envoyees a 1' application Flash et 
recuperer d'autres donnees retournees par Flash en methode GET ou POST. Afin d'assurer cette double 
fonction, nous utiliserons un script PHP (voir le fichier repertoi re.php dans l'exemple de la 
figure 11-14). 
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repertoire. php 



en-lete : 
nom=Dupond 
prenom=Jean 
Iel=0145863585 
mail=j.dupond@aol com 



\ 



loadVariables( "repertoi re. php", "resultatl mc". "POST") 
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Un repertoire Flash-PHP 

Pour illustrer cet interfacage Flash-PHP, nous vous proposons de creer un petit repertoire realise a 
l'aide d'une animation Flash (repertoi re.fla) couplee a un script PHP (repertoi re.php). 

L'interface Flash est constitute d'un champ de saisie dans lequel l'utilisateur peut saisir le nom 
de la personne recherchee. Un bouton de validation permet d'appeler la methode 1 oadVari abl es 
afin d'envoyer en POST la valeur de ce champ au script PHP. En retour, le script PHP renvoie dans 
un clip resultatl_mc les coordonnees de la personne. Dans le clip, une boucle (semblable a celle 
utilise dans l'exemple precedent) s'effectue tant que la derniere valeur a charger n'est pas disponible 
(une valeur specifique, f i n="ok", sera envoyee pour indiquer la fin du chargement des donnees). Des 
que toutes les donnees sont chargees dans le clip, l'animation est dirigee vers l'etiquette Affiche qui 
permet d'afficher les coordonnees du contact. Si aucun nom de contact ne correspond au nom recherche, 
le script renvoie la valeur Inconnu. 

Le document Flash 

L'interface Flash est composee d'un formulaire contenant un champ texte de saisie (nom de variable : 
nomRecherche) et d'un bouton qui permet d'appeler la methode 1 oadVari abl es (nom d'occurrence du 
bouton : boutonl_btn). Un clip, dont l'occurrence est nommee resul tatl_mc, est dedie a la recupera- 
tion des donnees retournees par le script PHP. Ce clip comporte une etiquette Recherche sur laquelle 
l'animation boucle tant que toutes les donnees ne sont pas completement chargees. Une autre 
etiquette nommee Affiche correspond a l'affichage du tableau des coordonnees du contact. Ce 
tableau contient autant de champs texte dynamiques que de valeurs retournees par le script. Les noms 
de variable de chaque champ sont les memes que les noms des variables generees par le script PHP 
(nom, prenom, tel, mail). 

1. Creez un nouveau document Flash et sauvegardez-le sous le nom repertoi re.fla dans un sous- 
repertoire du dossier www/SITEflash/. Vous pouvez prendre par exemple le repertoire www/SITE- 
f 1 ash/3-progStructuree/chapll/l oadVari abl es/. 

2. Creez quatre caiques : Fond, Resultat, Formulaire et Action. 

3. Personnalisez le caique Fond en ajoutant un cadre qui contiendra les elements de l'application. 

4. Dans l'image 1 du caique Resultat, creez un clip resul tat_mc et nommez son occurrence 
resul tatl_mc. Ajoutez dans l'image cle 1 du clip resul tatl_mc quatre champs dynamiques et 
nommez respectivement leur champ Var : nom, prenom, tel etmail. 

5. Dans l'image 1 du caique Formulaire, inserez un champ texte de saisie et nommez son champ 
Var : nomRecherche. 

6. Dans l'image 1 du caique Action, ajoutez une methode de gestionnaire d'evenements afin 
d'appeler la methode 1 oadVari abl es et une methode gotoAnPl ay (cette methode est appliquee au 
clip et permet de demarrer la boucle de chargement) des que l'utilisateur clique sur le bouton 
bontonl_btn (voir figure 11-15). 
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Code a aj outer dans 1' image 1 du scenario principal : 

boutonl_btn.onRelease= functionO { 

1 oadVari abl es( "repertoi re.php" , "resul tatl_mc" , "POST" ) ; 
resul tatl_mc .gotoAndPl ay ( "Recherche" ) ; 
} 
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Figure 11-15 

Creation des quatre caiques du scenario principal et integration du code dans Vintage cle 1 du scenario principal 

7. Ouvrez le scenario du clip resul tatl_mc et creez trois caiques : Fond, Action et Label (voir 
figure 11-16). 
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Figure 11-16 

Integration du script de test de la boucle de chargement dans 1' image cle 15 du scenario du clip resultatl _mc 
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8. Dans le caique Fond, ajoutez sur la scene un cadre destine a delimiter la zone de resultat et inserez 
une image cle dans l'image 22. 

9. Dans l'image 1 du caique Action, ajoutez une instruction stop( ). 

10. Dans l'image 15 du caique Action, inserez une image cle vide et ajoutez les lignes de code 
suivantes afin de tester la fin du chargement (voir figure 1 1-17) : 

if(fin=="ok"){ 

gotoAndPl ay ( "Af f i che" ) ; 

}el se{ 

gotoAndPl ay ( "Recherche" ) ; 

} 
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Figure 11-17 

Creation des quatre champs de texte dynamiques dans Vintage cle 16 du scenario du clip resultatl _mc 



11. Dans l'image 16 du caique Action, inserez une image cle vide et ajoutez une instruction stop( ) 
puis ajoutez sur la scene quatre champs de texte dynamiques respectivement nommes : nom, 
prenom, tel etmail (voir figure 11-18). 

12. Dans le caique Label, definissez une zone nommee Recherche de l'image 2 a 14 et une deuxieme 
zone nommee Affiche de l'image 16 a 22. 
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Sequence 1 
U? Action 
[-} 0 Image 1 

B | Actions sur Image 1 

boutonl_btn.onRelease= function() { 
loadVariablesC'repertoire.php'V'resultatl.mc'V'POST"); 
resultat l_mc. gotoAndPlay("Recherche"); 
} 

\jj Formulaire 
B 0 Image 1 

^ bouton_btn, <boutonl_btn> 
Resultat 
B 0 Image 1 



[P Fond 
B 0 Image 1 
S fond 



resultat_mc, <resultatl. mc>(+i \j} Label 
B © Action 



resultatl mc 



B 0 Image 1 

H 3 Actions sur Image 1 
stop(); 
B 0 Image 15 

H 3 Actions sur Image 15 
if(fin=="ok"){ 

gotoAndPlay("Affiche"); 
>else{ 

gotoAndPlay("Recherche"); 

} 

B 0 Image 16 

B @ Actions sur Image 16 
stop(); 

B Fond 



Le document PHP 

Le fichier repertoi re.php a une double fonction : 

• recueillir le nom du contact recherche (SnomRecherche) puis realiser une recherche dans un tableau 
de variables contenant tous les contacts du repertoire ; 

• mettre en forme les differentes coordonnees du contact trouve arm de renvoyer les donnees vers 
l'interface Flash. 

La memorisation des contacts sera realisee a Faide d'un tableau de variables ($1 iste) a deux dimen- 
sions. Le premier indice correspond au numero du contact. Le second permet de distinguer les quatre 
types de coordonnees d'un contact (nom, prenom, tel et mail). Les valeurs du tableau sont affectees 
directement dans le script, mais il est facile de construire un tableau de donnees similaire a partir 
d'une source de donnees externe (fichier texte, XML ou base de donnees). 
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La valeur de la variable SnomRecherche (envoyee par le formulaire Flash) est utilisee dans la boucle de 
recherche afin de tester la correspondance de ce nom avec Fun des noms du tableau $liste. Afin 
d'eviter que la saisie d'un nom en majuscules ou en minuscules ne perturbe la recherche, la variable 
SnomRecherche est automatiquement transformee en majuscules avant d'etre utilisee dans la boucle de 
recherche (instruction PHP strtoupper($nomRecherche)). Des que le contact est trouve, son numero 
(premier indice du tableau $liste) est memorise dans une variable SiDresultat. Lors de la mise en 
forme des donnees des resultats, cette meme variable est utilisee pour recuperer les quatre coordonnees 
issues du tableau $1 i ste. 

A noter 

Pour la mise en forme des donnees, une fonction envoi ( ) est utilisee afin d'eviter de repeter le script de mise en 
forme pour chaque couple de variable/valeur. 

1. Creez un nouveau document PHP (Fichier>Nouveau>Page dynamique>PHP) et sauvegardez-le 
sous le nom repertoi re.php dans le meme repertoire que le document Flash. 

2. Passez en mode Code et saisissez la premiere ligne de script ci-dessous dans la fenetre du document 
(voir figure 11-19). 

<?php 

// Initialisation des variables (parametre de recherche : nomRecherche envoye en POST 
*par Flash) 

i f (i sset($_P0ST[ 'nomRecherche ' ] ) ) $nomRecherche=$_POST[ ' nomRecherche' ] ; 
else SnomRecherche^"" ; 

3. Ajoutez a la suite le script suivant, destine a declarer la fonction envoi ( ) utilisee pour la mise en 
forme des donnees renvoyees a Flash (voir figure 11-19) : 

// envoi () Fonction de mise en forme des donnees retournees vers Flash 
// ENTREE : deux arguments : $var = le nom de la variable et $val 

la valeur correspondante 
// SORTIE : affiche le couple &variable=valeur conforme au format de chargement 
*»de donnees Flash 
function envoi($var, $val){ 
echo "&" . $var . " = " . utf8_encode($val ) ; 
} 

4. Ajoutez ensuite le script suivant, destine a initialiser le contenu du tableau $liste contenant les 
differents contacts du repertoire : 

// Creation d'un tableau de contacts $liste pour les tests 

$contactO=array( "Inconnu" ,"--","--","--"); 

$contactl=array( "DUPOND" , "Jean" , "0145863585" , " j .dupond@aol .com" ) ; 
$contact2=array( "VERMONT" , "Patrice" , "0145568749" , "p.vermont@wanadoo.fr" ) ; 
$contact3=array( "DUMOULIN" , "Maurice" , "0460258936" , "m.dumoul in@f ree . f r" ) ; 
$1 iste=array($contact0,$contactl,$contact2,$contact3) ; 

5. Ajoutez ensuite le script suivant, qui permet de generer la boucle de recherche et de parcourir 
ainsi tous les noms du tableau $1 i ste (voir figure 1 1-19) : 

// Recherche des coordonnees du contact 

$nomRecherche=strtoupper( SnomRecherche) ; 
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II Transforme le nom recherche en Majuscule 
$iDresultat=0; 

// Initialisation de l'ID du contact correspondant a la recherche 
for($1=l;$K=count($Hste);$1++){ 
if ($liste[$i][0]==$nomRecherche) $i Dresul tat=$i ; 

} 

6. Ajoutez enfin ce dernier script afin de mettre au format URL les donnees a renvoyer a Flash en 
appelant la fonction envoi ( ) declaree ci-dessus : 

// Mise en forme de la reponse envoyee a Flash 

envoi ("nom" ,$liste [$i Dresul tat] [0]) ; 
envoi ( "prenom" ,$1 i ste[$i Dresul tat] [1] ) ; 
envoi ("tel " ,$1 i ste[$i Dresul tat] [2] ) ; 
envoi ( "mail " ,$1 i ste[$i Dresul tat] [3] ) ; 
envoi ( "fin" , "ok" ); //drapeau de fin de donnees 

7. Enregistrez le document PHP. 
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i£(i3set((_POST[ 'noaRecherche ' ]) ) SnoaRecherche»(_POST[ 'noaRecherche' ]; else tnomRecherche-""; 

; // tUTREI : 2 arguments : fvar ■ le noa de la variable et (val ■ la valeut correspondante 

// SORTIE : affiche le couple tvariable-valeur confotae au fotaat de chargeaent de donnees Flash 
function envoi ((v*r, (val)j 

echo "4".<var."-".utC8 encode («val) ; _ _. ... 

} " Fonction envoi() 



■ :■■ <■ ■ ■ ?.e pour les tests 
fcontactO-attay ("Inconnu" — — ") ; 

*contaccl«array("DOPOIID","Jean™,"O14586358S","l.dupond0aol.co»") ; 
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( 1 is te= array ( (contac tO, f contactl,f contact2, (contact3) ; 
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//-- Recherche des cooidoimees du contact 

$noaRecherche-strtoupper («noaRecherche) ; transforae le noa recherche 
(U>cesulC«t>0;//init de l'ID du contact correspondant a la recherche 
f or (« l- 1 ;i i<-count [f liste) ( 
if(«llsu[«l}[0)--«noaRechecche) «lDresultat-«l; 



Boucle de recherche 
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envoi ("prenoa" , < liste t <iDresul tat J [ 1 ] ) ; 
envoi ( " tel" , f lis te [ ( IDresul tat] [ 2 J ) ; 
envoi C'i»ail ',$li3te[UDresultat][ : I]) ; 

envol( H fia"»"ok");//drapeau de fin de donnees 

r, Mise en forme des donnees retournees a Flash 
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Figure 11-19 

Saisie et enregistrement avec Dreamweaver des scripts dufichier repertoire.php 
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Test dans le WebLocal 

Pour le test, il suffit d'appeler le fichier repertoire.htm depuis votre Web local (selectionnez 
l'option local host depuis le menu du manager de Wamp. Cliquez ensuite successivement sur 
les differents dossiers afin d'afficher le fichier repertoire.htm). Une fois le formulaire de recher- 
che affiche a l'ecran, saisissez un nom dans le champ (Dupond, par exemple) et cliquez sur 
lebouton OK. La recherche est lancee et les resultats doivent s'afficher dans l'interface (voir 
figure 11-20). 
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Figure 11-20 

Test du repertoire dans le WebLocal 



Interfagage Flash-PHP avec la classe loadVars 

L' utilisation de la classe LoadVars est une alternative a Futilisation des methodes loadVariablesO et 
1 oadVari abl esNum( ) pour l'echange des donnees entre Flash et une source de donnees ou une appli- 
cation serveur (script PHP, par exemple). 

Une fois l'instance de la classe creee (objet LV cree avec new LoadVars( )), il suffit ensuite d'utiliser 
ses methodes (loadO, sendO et sendAnLoad( )) pour gerer des transferts de donnees depuis la 
source vers Flash (chargement), de Flash vers une application serveur (envoi) ou d'une maniere bidi- 
rectionnelle (interfa5age). La methode toStringO permet de coder les couples variable/valeur de 
1' objet LV en une chaine au format URL (varl=valeurlvar2=valeur2...). De meme, les classes getBytes- 
LoadedO et getBytesTotal ( ) permettent, lors de Futilisation des methodes loadO ou sendAnl_oad( ), 
de connaitre le nombre d' octets telecharges (dans le cas d'un chargement en cours) et le nombre total 
d'octets telecharges (a la fin du chargement). 
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La classe LoadVars met aussi a votre disposition deux proprietes, contentType et loaded, qui 
permettent de modifier le type MIME des donnees avant un envoi (le type par defaut est appl i ca- 
tion/x-www-url form-encoded) et de savoir si un chargement est termine (dans ce cas, la propriete 
loaded est a l'etat true). 

Enfin, deux gestionnaires d'evenements, onData et on Load, permettent de controler la fin du charge- 
ment avant ou apres l'analyse des donnees par Flash Player lors de Fusage d'une methode 1 oad( ) ou 
sendAndLoad( ). 

Tableau 11-10. Syntaxe du constructeur de la classe loadVars 

Classe 1 oadVars 

La classe 1 oadVars permet de creer des objets (monObjet_l v) et d'utiliser ensuite leurs methodes pour envoyer ou charger 
des donnees. 

Creation d'un objet a I'aide du constructeur : 
var monObjet_lv = new loadVarsO 

Tableau 11-11. Methodes d'envoi et de chargement de la classe loadVars 

Definitions des parametres 

url : URL absolue ou relative de la source de don- 
nees. Si le fichier SWF resultant de cet appel est 
ouvert dans un navigateur Web, I'URL doit etre du 
meme domaine que le fichier SWF. 

cible : fenetre du navigateur dans laquelle les 
reponses seront affichees. Par defaut, la cible est 
_self (fenetre courante) mais vous pouvez utiliser 
_bl ank (nouvelle fenetre), _parent (fenetre du cadre 
parent) ou _top (fenetre du cadre principal). 

methode : permet de specifier la methode HTTP utili- 
ses (GET ou POST). Si aucune methode n'est precisee, 
la methode POST sera utilisee par defaut. 

objetCible : objet LoadVars qui recoit les valeurs 
chargees (Attention ! Le nom de cet objet ne doit pas 
etre encadre par des guillemets). 

[xxx] : le code xxx est facultatif. 

(Attention ! Vous ne devez surtout pas saisir les 
crochets [ et ] dans le code.) 



Methodes 



monObjet_lv. load ("url ") 

Charge des variables depuis I'URL specifiee, analyse les donnees et 
place les variables resultantes dans I'objet monObjet_l v. 

mon0bjet_1v.send("url " [."cible" ."methode" ]) 
Envoie les variables de I'objet monObjet_l v a I'URL specifiee. Toutes 
les variables enumerates dans monObjet_lv sont concatenees 
dans une chaine au format application/x-www-form-urlen- 
coded par defaut (ce format MIME peut etre modifie au prealable a 
I'aide de la propriete contentType). 

monObjet_l v.sendAndLoad( "url " , objetCible [."methode"]) 
Envoie les variables de I'objet monObjet_lv a I'URL specifiee et 
charge les variables issues de la reponse du serveur dans I'objet 
objetCible. 
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Tableau 11-12. Autres methodes de la classe loadVars 



Methodes 



monObjet_lv.getBytesLoaded( ) 

Renvoie le nombre d'octets deja telecharge lors d'un chargement de 
donnees initie par I'appelde la methode 1 oad( ) ou sendAndLoadt ) . 



Definitions des parametres 

nomDentete : nom d'en-tete de requete HTTP 

val eurDentete : valeur associee a nomDentete 



monObjet_lv. getBytesTotal ( ) 

Renvoie le nombre total d'octets telecharges apres un chargement de 
donnees initie par I'appel de la methode 1 oad( ) ou sendAndLoadt ). 
Cette methode renvoie undef i ned si aucune operation load n'est en 
cours ou si une operation 1 oad n'a pas encore ete initiee. 

monObjet_Rv.addRequestHeader( ' 
Premiere utilisation : 

monObjet_l v. add RequestHeader( nomDentete, val eurDentete) 



tabEnTete : tableau de variables contenant les cou- 
ples nomDentete_n et val eurDentete_n. Ce tableau 
est ensuite transmis en parametre lors de I'appel de la 
methode addRequestHeaderO. 

(*) Attention ! 

Dans la syntaxe de la methode addRequestHea- 
der( ), vous devez saisir les crochets [ et ] dans le 
code car il s'agit dans ce cas de delimiteurs de 
tableau de variables. 



Seconde utilisation : 

tabEnTete = ["nomDentete_l" , "valeurDentete_l" 
"nomDentete_n" , "valeurDentete_n"] ; 
monObjet_l v. addRequestHeadert tabEnTete) ; 

Ajoute ou modifie les en-tetes de requete HTTP (telles que Content- 
type ou SOAPAction) envoyes avec les actions POST. 

Dans la premiere utilisation, vous transmettez deux chaines a la 
methode : nomDentete et val eurDentete. 



Dans la seconde utilisation, vous transmettez un tableau de chaines*. 
alternant noms et valeurs d'en-tetes. 



Tableau 11-13. Proprietes de la classe loadVars 

Descriptions des proprietes 

monOb jet_l v . 1 oaded 

La propriete 1 oaded indique si une operation de chargement de donnees initiee par I'appel de la methode 1 oad( ) ou sendAn- 
dLoadt ) est terminee. Elle est affectee de la valeur true lorsque Poperation est terminee et de la valeur false dans le cas 
contraire. Si une operation de chargement echoue avec une erreur, la propriete loaded reste definie sur la valeur false. 
A noter : Si la methode 1 oad( ) ou sendAndLoadt ) n'a pas encore ete initiee, cette propriete renvoie la valeur undefined. 

monOb jet_l v . contentType 

La propriete contentType est utilisee pour modifier le type mime ajoute a I'en-tete HTTP lors de I'envoi de donnees initie par 
I'appel de la methode sendt ) ou sendAndLoadt ). Par defaut, cette propriete est affectee avec la valeur appl ication/x-www- 
url form-encoded. 
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Tableau 11-14. Gestionnaires d'evenements de la classe loadVars 
Gestionnaires d'evenements 



monObjet_l v.onData = function (src) { 
// Mettre ici vos instructions } 
Legestionnaire d'evenements onData est invoque si les donnees 
ont ete completement telechargees lors d'un chargement initie 
par I'appel de la methode load( ) ou sendAndLoadt ).Cegestion- 
naire etant invoque avant I'analyse des donnees, il peut etre utilise 
pour appeler une routine d'analyse personnalisee au lieu d'une 
routine integree dans Flash Player. Par defaut, la routine appelee 
est monObjet_l v. on Load (voir ci-dessous) mais si vous affectez 
une fonction personnalisee a monObjet_l v. onData, la routine 
monObjet.onLoad ne sera plus appelee, a moins que vous ne 
I'ajoutiez dans les instructions de la fonction personnalisee. 
monObjet_lv.onl_oad = function (success) { 
// Mettre ici vos instructions ) 
Si aucune fonction personnalisee n'est affectee a I'objet 
monObjet_l v.onData (voir ci-dessus), le gestionnaire d'eve- 
nements onLoad est invoque par defaut des que le chargement 
initie par I'appel de la methode 1 oad( ) ou sendAndLoadt ) est 
termine. 

Si I'operation de chargement est reussie, I'objet monObjet_l v 
est alors renseigne par les valeurs telechargees. Ces varia- 
bles sont disponibles depuis I'objet monObjet_lv (ex : mon- 
ObjetJv. ma Var) lorsque le gestionnaire on Load est invoque. 



Definitions des parametres 

src : chaine contenant les paires nom-valeur encodees URL 
telechargees depuis le serveur. 

A noter : Si une erreur se produit lors du chargement, le para- 
metre scr est alors affecte avec la valeur undefined, 
success : ce parametre indique si I'operation de chargement 
s'est deroulee avec succes (true) ou non (f al se). 
Remarque : En pratique dans la plupart des applications, on uti- 
lise uniquement le gestionnaire d'evenements on Load pour gerer 
les variables telechargees (comme dans I'exemple ci-dessous). 
Exemple : 

Script place dans I'image 1 du scenario principal de I'animation 
loadVars. f 1 a : 

monObjet_lv= new LoadVarsO; 
monObjet_l v. 1 oad( "f ichier.txt" ) ; 
monObjet_l v. on Load=f unction (success) { 
if (successH 

_root.nom= monObjet_l v.maVarl ; 
_root.prenom= monObjet_l v .maVar2 ; 
} else { 

gotoAndStopt "Erreur" ) ; 



Contenu du document fichier.txt : 

&maVarl=Def rance&maVar2=Jean-Marie 



Figure 11-21 

Utilisation des differentes 
methodes de la classe loadVars 
pour gerer le chargement ou 
V envoi de donnees entre une 
animation Flash et une source 
de donnees ou une application 
serveur PHP. 
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Exemples de scripts utilisant la classe loadVars 
Chargement dans un tableau avec load() 

Ce script permet de charger dans une animation Flash sept variables (les sept jours de la semaine : 
jourl=l undi, jour2=mardi, etc.) depuis un fichier texte fichierJour.txt. Des que le chargement est 
termine, la tete de lecture de 1' animation est envoyee vers une image Affiche et ces variables sont 
affectees a un tableau de variables nomme monTableau_array. Si un probleme survient lors du char- 
gement, la tete de lecture de 1' animation est envoyee vers une image Erreur. 

Script a ajouter dans l'image cle 1 du scenario principal : 

Stop( ) ; 

// Creation du tableau recepteur 
monTableau_array=new ArrayO; 
// Creation de 1'objet LV 
monObjet_lv= new LoadVarsO; 
// Chargement du fichier 
monObjet_lv. load ("fichier Jours.txt") ; 
// Gestionnaire d'evenement onLoad 
monObjet_l v. on Load=f unction (success) { 
if (success) ( 



Un champ texte dynamique dont l'occurrence sera nommee af f i cheTabl eau_txt doit etre cree sur la 
scene de l'image Affiche. 

Script a ajouter dans l'image nommee Affiche : 

Stop( ) ; 

affi cheTabl eau_txt. text=monTabl eau_array ; 

Contenu du document f i chi erJour . txt utilise dans le script precedent : 

I &jourl=Lundi&jour2=Mardi&jour3=Mercredi&jour4=Jeudi&jour5=Vendredi&jour6=Samedi&jour7 
*»=Dimanche&nbre=7& 



for (var n = 1; n<=monObjet_lv.nbre; n++) { 

monTabl eau_array .push (monObjet_l v[ "jour "+n] ) ; 
gotoAndStop( "Af f i che" ) ; 



) else { 



gotoAndStop( "Erreur" ) ; 
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Envoi vers un script avec send() 

Ce script permet d'envoyer des variables (proprietes ajoutees a Fobjet LV : monObjetJ v.monNom et 
monObjet_lv.monMessage) au script PHP afficheMessage.php. Le message recu par le script sera 
ensuite affiche dans une nouvelle fenetre (option _bl ank) (voir figure 1 1-22). 



r ■ — -- — . — ■ ■ 
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£\ Termme 




» J Intranet local 







Figure 11-22 

Message affiche dans le navigateur apres V envoi des donnees 



Script a ajouter dans V image cle 1 du scenario principal : 

Stop( ) ; 

// Creation de 1 ' ob jet LV 

monObjet_l v= new LoadVarsO; 

// Initialisation des variables 

monObjet_l v.monNom="Jean" ; 

monObjet_lv.inonMessage="bonjour a tous"; 

// Envoi des variables vers le script 

monObjet_lv.send("afficheMessage.php", "_blank", "GET"); 

Script PHP du fichier afficheMessage.php : 
<?php 

if (isset($_GET['monNom'])) $monNom= utf8_decode($_GET['monNom']); 

else $monNom="inconnu" ; 
if (isset($_GET['monMessage'])) $monMessage= utf8_decode($_GET['monMessage']); 

else $monMessage="inconnu" ; 
echo "Voici le nouveau message de <b>" .SmonNom. "</b> : <b>".$monMessage."</b>" ; 
?> 



Remarque 

Lors de nos tests de la methode send( ) , nous avons releve des problemes de fonctionnement avec la methode 
POST et Flash Player 6 et 7 sur les plates-formes PC (voir TechNote sur le site de Macromedia pour plus de 
details). 
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Envoi et chargement avec send And Load() 

Ce script permet d'envoyer un nom et un message depuis un formulaire Flash (animation renvoiMes- 
sage.fla) vers un script PHP (renvoiMessage.php). Le script PHP archive les differents messages 
recus dans un fichier texte (monMessage.txt) et renvoie a Flash un message attestant la bonne recep- 
tion. Flash charge ensuite le message de retour et raffiche dans un champ texte dynamique place sur 
la scene (retour_txt) (voir figure 11-23). 

Sur la scene de 1' animation, vous devrez au prealable creer deux champs de saisie d' occurrence 
nom_txt et message_txt, un bouton de validation d' occurrence boutonl_btn et un champ dynamique 
d'occurrence retour_txt. Dans l'image cle 1 du scenario principal, creez deux objets LV 
(monEnvoiJIv et monChargementJI v) afin de gerer Fenvoi et le chargement dans des objets differents. 
Le chargement et Fenvoi seront declenches par une action sur le bouton boutonl_btn. 
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4)Tefmre 
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Figure 11-23 

Interface de V animation renvoiMessage.fla utilisee pour illustrer le fonctionnement de la methode 
senAndLoad( ) 



Script a ajouter dans l'image cle 1 du scenario principal : 

Stop( ) ; 

// Creation des objets LV 

monEnvoi_l v = new LoadVarsO; 

monChargement_l v = new LoadVarsO; 

boutonl_btn.onRelease = functionO { 
// Initialisation des variables 
monEnvoi_lv.monNom = nom_txt.text; 
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monEnvoi_lv.monMessage = message_txt.text; 
// Envoi des variables vers le script 

mon En voi_l v. sendAnd Load ( "renvoi Message. php" , monChargement_l v , "POST" ) ; 
// Affiche resultat chargement 
monChargement_lv.onLoad = function(success) { 
if (success) ( 

_root.retour_txt.text = monChargement_lv.retour; 
} else { 

_root. retour_txt.text = "probleme de chargement"; 

} 

}; 

}; 

Script PHP du fichier renvoiMessage.php : 
<?php 

// Recuperation des variables envoyees par Flash 

if (isset($_POST[ 'monNom' ] ) ) $monNom= utf8_decode($_P0ST[ 'monNom' ] ) ; else $monNom="inconnu" ; 

if (isset($_POST[ 'monMessage' ] ) ) $monMessage= utf8_decode($_P0ST[ 'monMessage' ] ) ; 

*»else $monMessage="inconnu" ; 

// Preparation du message de retour 

$messageRetour="Votre message : \"".$monMessage."\" a bien ete enregistre "; 

$messageRetour=utf8_encode($messageRetour ) ; 

echo "&retour=" .SmessageRetour. "&" ; 

// Preparation du texte a sauvegarder dans le fichier 

$monTexte=" — Emetteur : ".SmonNom." — Message : ".SmonMessage." \n"; 

$f ichier=f open ( "monMessage. txt" , "a" ) ; 

fputs($fichier,$monTexte) ; 

fclose(Sfichier) ; 

?> 

Contenu du fichier monMessage.txt apres quatre envois de message : 
— Emetteur : Dupond — Message : Merci de m'envoyer votre CR 
— Emetteur : Hamond — Message : Mon CR a deja ete envoye hier 
— Emetteur : Dupond — Message : Desole mais je n'ai rien recu ! 
— Emetteur : Hamond — Message : Ok, je vous envoie une copie 

Aff ichage du taux de chargement 

Ce script montre comment utiliser les methodes getBytesLoaded( ) et getBytesTotal () pour afficher 
l'etat du chargement. 

Script a ajouter dans F image cle 1 de F animation : 

monObjet_lv = new LoadVarsO; 
monObjet_l v.load( "grosFichier.txt") ; 
_root.onEnterFrame = functiont) { 

var chargePourcentiNumber; 

if (monObjet_lv. loaded == false) { 
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chargePourcent=Math .ceil ( (monObjet_l v. getBytes Loaded ( ) 
*7mon0bjet_l v.getBytesTotal ( ) )*100) ; 

chargePourcent=( i sNaN(chargePourcent) )?1 :chargePourcent ; 

tracet "Tel echargement effectue : "+monObjet_lv.getBytesl_oaded( )+" octets"); 

traceC'Taux de chargement : "+chargePourcent+"%" ) ; 
} else { 

traceC'Le chargement est termine"); 

trace("Total telecharge : "+Math.fl oor(monObjet_l v.getBytesTotal ( )/1024)+"Ko" ) ; 
delete this.onEnterFrame; 

} 

}; 



Un compteur Flash-PHP-Txt 

Pour illustrer cet interfacage Flash-PHP-Txt, nous vous proposons de creer un systeme de comptage 
des pages visitees dans une animation Flash. Ce systeme sera realise a l'aide d'une animation Flash 
(compteur. f la) couplee a un script PHP (compteur. php). Differents fichiers texte (autant que de 
pages d'animation a gerer) seront regroupes dans un repertoire specifique nomme compteurs/. 

L'interface Flash est constitute d'un ensemble de trois boutons permettant d'acceder a des etiquettes 
differentes (pagel, page2 et page3). Un champ de texte dynamique place au centre de la scene 
permet d'afficher l'etat du compteur de la page active. L'image 1 du scenario principal regroupe 
les gestionnaires des boutons, le script de creation de l'objet LoadVars et son gestionnaire onLoad 
ainsi qu'une fonction compte(n). Lorsque Ton clique sur Tun des trois boutons, la tete de lecture se 
positionne sur la page desiree. Chaque page contient un appel a la fonction compte( ) qui est confi- 
guree pour passer en parametre le numero de la page visualisee (exemple : compte ( 2 ) pour la page 2). 
Cette fonction envoie un ordre de chargement au script compteur . php en lui passant le numero de la page 
en parametre d'URL. Des reception de cette valeur, le script PHP lit le fichier texte correspondant, 
incremente l'ancienne valeur et renvoie le nouvel etat du compteur au fichier Flash pour affichage. 
Cet etat sera ensuite memorise dans le fichier texte afin de comptabiliser les visites de la page 
concernee. 



Le document Flash 

Le document Flash est organise en cinq caiques (Label, Action, Menu, Message et Fond). Le scenario 
est decoupe en quatre zones. La premiere correspond a l'image 1 et regroupe les differents scripts 
de 1' animation ; les trois autres portent les etiquettes pagel, page2 et page3 et simuleront les pages de 
l'animation pour lesquelles le nombre de visites devra etre comptabilise. 

1. Creez un nouveau document Flash et sauvegardez-le sous le nom compteur.fla dans un sous- 
repertoire du dossier www/SITEflash/. Vous pouvez prendre par exemple le repertoire www/SITE- 
f 1 ash/3-progStructuree/chapll/l oadVars/. 

2. Creez cinq caiques : Label, Action, Menu, Message et Fond. 

3. Personnalisez le caique Fond en ajoutant un cadre qui contiendra les elements de F application 
puis inserez une image cle dans l'image 31 du scenario. 
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4. Dans F image 1 du caique Message, creez un champ de texte dynamique et nommez son occur- 
rence visite_txt puis inserez une image cle dans l'image 31 du scenario. 

5. Dans l'image 1 du caique Menu, inserez trois boutons et nommez leurs occurrences respectives : 
pagel_btn, page2_btn et page3„btn puis inserez une image cle dans l'image 31 du scenario. 

6. Dans l'image 1 du caique Action, ajoutez trois methodes de gestionnaire d'evenements onRe- 
1 ease pour les boutons des pages ami d'envoyer la tete de lecture sur l'etiquette correspondante. 

7. Dans la meme image cle, ajoutez le constructeur de la classe loadVars et son gestionnaire 
d'evenements on Load. Definissez a la suite la fonction compte(n) afin qu'elle appelle la methode 
1 oad( ) tout en passant le numero de la page (n) en parametre d'URL a la suite du nom du script 
(voir figure 11-24). 
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stop [ ) ; 



// Hethodes de gestionnaire des ben 

pagel_btn.onRelease ■ funetion() { 
gotoAndStop ("pagel") ; 

); 

page2_btn.onRe lease ■ function () { 
gotoAndStop ("page2'*) ; 

>; 

| page3_btn. onRelease * function!) ( 
gotoAndStop (**page3 ") ; 



1 1 ! '. '. 1 1 . . 

var compteur_lv:LoadVars ■ new LoadVars(); 

/ / Declaration de I'Aveneioent onLoad 

coropteur_lv. onLoad ■ function (success) { 
If (success) ( 

_root. visite - cotnpteur_lv.n; 
) else ( 

_root. visite ■ "Erreur**; 

} 

> ; 

//----- — Appel du compteur 
function compte(n) { 

co»pteur_lv. load ("compteur . php?page-"+n 
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Figure 11-24 

Creation des cinq caiques du scenario principal et integration du code dans l'image cle 1 de ce meme scenario 



8. Ajoutez en bas de cette image un gotoAndStop( "pagel " ) afin que l'animation demarre automati- 
quement sur la premiere page. Enregistrez puis publiez l'animation. 
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Code a aj outer dans 1' image 1 du scenario principal (voir figure 1 1-24) : 
stop( ) ; 

II Methodes de gestionnai re des btn 

pagel_btn.onRelease = functionO { 
gotoAndStop( "pagel" ) ; 

}; 

page2_btn.onRelease = functionO { 
gotoAndStop( "page2" ) ; 

}; 

page3_btn.onRelease = functionO { 
gotoAndStop( "page3" ) ; 



}; 

II Creation de 1 'objet LV 

var compteur_lv:LoadVars = new LoadVarsO; 
II Declaration de 1 'evenement onLoad 



compteur_lv.onl_oad = function(success) { 
if (success) { 

_root.visite = compteur_l v . n ; 
} else { 

_root.visite = "Erreur"; 

} 

); 



II Appel du compteur 

function compte(n) { 

compteur_l v . 1 oad( "compteur . php?page="+n) ; 

1 

// go pagel 



gotoAndStop( "pagel" ) ; 

Le document PHP 

Le fichier compteur. php doit lire le fichier texte de la page concernee (et le creer s'il n'existe pas. 
Exemple : visitePage2.txt) afin de recuperer la valeur du compteur. Ensuite, il doit incrementer la 
valeur du compteur, la sauvegarder dans le fichier texte et la mettre au format URL pour la retourner 
a Flash. 

1 . Creez un nouveau document PHP (Fichier>Nouveau>Page dynamique>PHP) et sauvegardez-le 
sous le nom compteur. php dans le meme repertoire que le document Flash. 

2. Passez en mode Code et saisissez la premiere ligne de script ci-dessous dans la fenetre du document 
(voir figure 1 1-25). Cette instruction permet d'initialiser la variable page passee en parametre lors 
de l'appel du script depuis Flash (compteur. php?page="+n) : 

<?php 

// Initialisation des variables 

if(isset($_GET['page'])) $page=$_GET[ ' page' ] ; else $page=0; 

// 
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Initialisation de la variable Spage 

if (i3set(S_GET[ 'page 1 ]) > $page«S_GET[ "page ' ]; else tpage-0; 



ir ((page 1 -0) { 

// — ouvte le cichiei txt du coapteut de la page concecnee 
i£( f<CichleE-6iopen("coBpceuc3/vialMPage". Spage.". t3tc" / "t+'*> ) 
( 

I fichiet"Copen("coapteuts/visttePage".tpage.". txt" ,"»+") ; 

Lecture du ffichier txt (et creation s'il n'existe pas) 

Sx-c gets (i cichier. , I ' I) ; 

//--test si le fichier. est vide et mit de x a 0 dans ce eas (cas d'une creation i 
lt((x»»' ') Sx-o; 

//--incteaente la variable de coapteuc 
«x++; 

//repojitlonne le pointeuc au debut du fichier. 
CseekKClchiecO); 
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Figure 11-25 

Saisie et enregistrement avec Dreamweaver des scripts dufichier compteur.php 



3. Ajoutez a la suite le script suivant, destine a ouvrir le fichier texte (option r+) ou a le creer (option 
w+) s'il n'existe pas (pour connaitre les specificites de chaque option de fichier, reportez-vous au 
tableau 6-17 du chapitre 6) : 

//--Teste si un numero de page est bien envoye 
if ($page!=0){ 

//--Ouvre le fichier .txt du compteur de la page concernee 
if ( ! $f ichier=@fopen( " compteur s/vi si tePage" . $page. " .txt" , "r+" ) ) 
{ 

// Si le fichier n'existe pas, il est cree vide 
$fichier=fopen( " compteur s/vi si tePage" . $page. " .txt" , "w+" ) ; 
} 
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4. Ajoutez le script suivant, destine a lire les dix premiers caracteres du contenu du fichier (ou a 
initialiser a 0 la valeur $x si le fichier vient d'etre cree). La derniere ligne de ce fragment de code 
permet d'incrementer la valeur du compteur : 

//--Lecture des dix premiers chiffres 
$x=fgets($fichier,10) ; 

//--Teste si le fichier est vide et init de x a 0 dans ce cas (cas d'une creation 
*-de fichier) 
if($x==") $x=0; 

//--Incremente la variable de compteur 
$x++; 

5. Ajoutez le script suivant, qui repositionne le pointeur au debut du fichier avant de sauvegarder la 
nouvelle valeur et de fermer le fichier : 

// Repositionne le pointeur au debut du fichier 
fseek($fichier,0); 

//--Ecriture de la nouvelle valeur dans le fichier 
fputs($fichier,$x) ; 
//--Ferme le fichier 
fclose($fichier) ; 

6. Ajoutez enfin ce dernier script afin de mettre au format URL la nouvelle valeur du compteur pour 
la renvoyer a Flash : 

//--Mise en forme format URL et envoi de la nouvelle valeur a Flash 

echo "n=".$x; 
} // Fin du if page 
?> 

7. Enregistrez le document PHP. 
Creation du repertoire compteur/ 

Tous les fichiers memorisant les compteurs des pages sont regroupes dans un meme repertoire 
nomme compteur/. Si le script presente ci-dessus permet de creer automatiquement le nouveau fichier 
d'une page, il faut cependant creer au prealable ce sous-repertoire (dans le meme dossier que celui ou 
vous avez enregistre les fichiers compteur. php et compteur. f la). 

Si vous desirez mettre votre application en ligne, il vous faudra modifier les droits de ce reper- 
toire (CHMOD) afin de pouvoir modifier les fichiers qu'il contient. Le plus simple est d'utiliser votre 
client FTP habituel (en general, il faut faire un clic droit sur le repertoire et selectionner l'option 
CHMOD). 
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Test dans le WebLocal 

Pour le test, il suffit d'appeler le fichier compteur.htm depuis votre Web local (selectionnez l'option 
1 ocal host depuis le menu du manager de Wamp. Cliquez sur les differents dossiers arm d'afficher le 
fichier compteur.htm). Une fois la premiere page de votre animation affichee a l'ecran, cliquez 
plusieurs fois sur les autres pages arm de verifier que les compteurs evoluent bien (voir figure 1 1-26). 



Codes sources disponibles en ligne 

Tous les codes sources des applications presentees dans cet ouvrage sont disponibles sur Internet : 
www.editions-eyrolles.com (mots-cles : Fl ash PHP). 
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page 1 



page 2 



page 3 



Bienvenue sur la page 

2 

cette page a deja ete consuUec 

18 fois 



Figure 11-26 

Test du compteur dans le 



WebLocal 



Partie IV 
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Introduction a la programmation 

orientee objet (POO) 



Le concept de la programmation orientee objet s'inspire des objets (materiels ou immateriels) de la 
vie de tous les jours. En effet, tous les objets qui nous entourent possedent des caracteristiques qui 
leur sont propres (couleur, poids...) et peuvent realiser les actions pour lesquelles ils ont ete concus 
(avancer, tourner, emettre un bruit. . .). La POO permet d' exploiter les actions de ces objets (que nous 
nommerons par la suite methodes) et de modifier leurs caracteristiques (que nous nommerons par la 
suite proprietes) sans meme savoir comment ils sont reellement constitues. Si Ton ajoute a cela la 
possibilite de creer de nouveaux objets a partir d'objets existants, on comprend rapidement Finteret 
d'utiliser les objets en programmation lorsque Ton desire etre productif et capitaliser ses developpements. 

Notion de classe et d'objet 

La classe definit les proprietes et les methodes des futurs objets. Par exemple, la classe voiture 
comporte des proprietes qui peuvent etre la couleur ou la vitesse, de meme que ses methodes lui 
permettront de freiner ou d'accelerer. Une classe est en quelque sorte un modele (voir figure 12-1). 

En general une classe ne peut pas etre utilisee directement et il faut d'abord en creer une occurrence 
(on parle dans ce cas d'« instanciation ») pour creer un objet qui correspondra a son image. Pour cela, 
on appelle une methode specifique de la classe, nommee constructeur. Lors de 1' instanciation, un 
objet possedant les memes methodes et proprietes que la classe mere est cree. 



Remarque 

En AS, certaines classes peuvent etre exploitees directement (sans devoir creer un objet au prealable), comme les 
classes Mouse ou Key, par exemple. 
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Figure 12-1 

Creation d'un objet lors de 
V instantiation d'une classe 




Objet 98W75 Objet 45Y92 



(instance ae la cMssa VOITUREI (instance oe la classe VOITUREI 

M6thodes : Proprietes : Methodes : Proprtetes : 

> accelerer() > couleur : bleue > accelerer() > couleur : rouge 

>freiner() > vitesse : 60 >freiner() > vitesse : 10 



Heritage et notion de sous-classe 

Dans certains cas, il est tres interessant de creer des sous-classes d'une classe (appelee dans ce 
cas la « classe mere »). Les attributs et methodes d'un objet d'une sous-classe sont herites de ceux de 
la classe mere, mais des attributs et des methodes specifiques peuvent etre ajoutes a cette sous-classe 
(voir figure 12-2). Ce concept est important, car la principale caracteristique de la programmation par 
objet est la possibilite pour une classe d'heriter des proprietes et des methodes d'une autre classe. 



Figure 12-2 

Creation d'une sous-classe 
et principe de V heritage 




Classe VOITURE 

(Classe "mem") 
M6thodes : Proprietes : 

> acoelerer() > couleur 

> freiner() > vitesse 



{creation o"tma sotis-dassaCAMlONNETTE Uoi-ifano 
a part* da la classe mam VOITURE) neilldye 



Sous-classe CAMIONNETTE 

M6thodes : Propri6t6s 

> accelerer() > couleur 

> freinerf) > vitesse 

> volume_charge 





Objet 63BB78 

(Instance de la sous-classe CAMIONNE TTEI 

Methodes : Proprietes : 

> accelerer() > couleur : verte 

> freiner() > vitesse : 5 



Objet 25HH75 

tlnxlatMM do la sotix-ctassa CAMIONNETTE) 

Methodes : Proprietes : 

> accelerer() > couleur : orange 

> freinerf) > vitesse : 40 



> volume_charge : 2.2 



> volume_charge : 3.6 
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Terminologie de la POO 

En programmation orientee objet, on utilise souvent des termes specifiques dont voici la definition. 

Classe - une classe represente le modele utilise pour creer les futurs objets (la creation d'un objet se 
conformant a la definition d'une classe est appelee « instanciation »). Elle comporte des variables 
chargees de decrire les proprietes de Fobjet, ainsi que des methodes chargees de definir son compor- 
tement. Par exemple, la classe voiture definit le modele utilise pour creer des objets correspondant 
aux differentes voitures immatriculees. 

Objet - un objet est cree par instanciation de la classe qui le decrit (on appelle aussi « instance d'une 
classe » l'objet ainsi cree). Par exemple, la voiture immatriculee 89W75 est un objet de la classe 
voiture. 

Proprietes - ce sont les caracteristiques d'une classe (constantes, variables internes. . .) qui personna- 
lisent un objet. Par exemple, la couleur et la vitesse sont des proprietes de l'objet immatricule 89W75. 

Methode- une methode n'est rien d' autre qu'une fonction figurant dans une classe (integree ou 
personnalisee) et qui s' applique a un objet. Les methodes s'appuient sur des parametres passes lors 
de leur appel ou sur les attributs declares dans la classe (constantes, variables internes. . .). Par exemple, 
les actions freiner ou accelerer sont des methodes disponibles pour l'objet immatricule 89W75. 

Constructeur - un constructeur est une methode particuliere, qui porte le meme nom que la classe et 
qui est appelee automatiquement lorsque vous creez une nouvelle instance (done un nouvel objet). 
Le constructeur permet, entre autres, d'initialiser par defaut les attributs de l'objet lors de l'instanciation. 
Par exemple, la methode voiture peut etre le constructeur de la classe voiture et initialiser par defaut 
la vitesse de l'objet a 0 lors de sa creation. 

Sous-classe - une sous-classe est une classe qui herite d'une autre classe (la classe mere) et a 
laquelle on ajoute des proprietes et des methodes specifiques (break, cabriolet ou camionnette sont 
des sous-classes de la classe mere voiture). 

Heritage - 1' heritage definit une sous-classe comme appartenant a la meme famille qu'une autre 
classe (classe mere), ann qu'elle herite des merries attributs (proprietes) et methodes que cette 
derniere. L'interet des sous-classes est qu'on peut ajouter des methodes ou proprietes specifiques a 
celles de la classe mere dont elles sont issues. Par exemple, la sous-classe cami onnette peut heriter de 
la classe mere voiture, ann de recuperer ses attributs (exemple : couleur, vitesse) et ses methodes 
(exemple: freinerO, accelererO) et disposer en plus d'une propriete specifique vol ume_charge 
(volume de chargement de la camionnette). 
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Declaration d'une classe 

En PHP, la definition d'une classe commence par le mot-cle class, suivi du nom de la classe 
(exemple : cl ass venture) et, comme pour les fonctions utilisateur, d'un bloc d' instructions delimite 
par des accolades (exemple : cl ass voitu re {...}). A l'interieur de ces accolades, on definit les proprie- 
tes et les methodes qui seront exploiters par la suite en utilisant un accesseur et la variable $this qui 
designe Fobjet courant (exemple : $this->vitesse). La syntaxe d'un accesseur est constitute des 
caracteres « -> », qui forment une fleche. On definit les proprietes (equivalentes aux variables de la 
classe) a l'aide du mot-cle public en PHP 5 suivi du nom de la variable interne (exemple : public 
$vitesse;)- On definit les methodes (equivalentes aux fonctions de la classe) a l'aide du mot-cle 
function, suivi du nom de la methode et du bloc d' instructions qui la compose, comme pour une 
fonction traditionnelle (exemple : function fre1ner{_}). 

II est possible d'utiliser une methode particuliere appelee « constructeur » pour initialiser un objet 

des sa creation. En PHP 5, le constructeur doit porter le nom construct ( ) . Afin d'eviter des erreurs 

dans votre programme, notez bien que le nom contruct( ) commence par 2 symboles « _ ». 



Declarer des proprietes en PHP 4 

En PHP 4, il fallait utiliser le mot-cle var devant la propriete a declarer. Pour garder la compatibility avec le PHP 4, 
vous pouveztoujours utiliser le mot-cle var a la place de publ ic mais sachez que cela risque d'afficher une erreur 
E_STRICT selon la configuration du niveau d'erreur dans le fichier php.ini. 
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Declarer des constructeurs en PHP 4 

En PHP 4, le constructeur etait une methode qui devait porter le meme nom que la classe (soit voi ture ( ) pour 
notre exemple de classe voi ture). Vous pouvez toujours utiliser cette ancienne methode en PHP 5 pour garder la 
compatibility avec PHP 4 mais, en revanche, il ne faut pas utiliser les deux ensembles au risque de voir s'aflicher 
une erreur E_STRICT. 



Void un exemple de declaration de la classe voi ture : 

// Declaration de la classe 

class voiture 
f 

/* Declaration des proprietes utilisees dans la classe */ 

public $couleur; 
public $vitesse; 

/* Declaration du constructeur de la classe voiture */ 

function const ruct($choix_coul eur) 

{ 

$this->vitesse=0; 

// Initialise la Vitesse a 0 par defaut lors de la creation de l'objet. 
$thi s->couleur=$choix_coul eur; 

/* La couleur est affectee selon le parametre qui est passe en argument lors 
de la creation de l'objet. */ 

} 

// Declaration des methodes communes a la classe voiture 

function accel erer( ) 
{ 

$this->vitesse++; 

// Incremente la vitesse si on accelere. 

} 

function freinerO 
{ 

if ($this->vitesse>0) 
{$this->vitesse-- ; } 

/* Decremente la vitesse si on freine sous la condition que la vitesse 
soit positive.*/ 

} 

}// Ffin de la classe voiture 



Declarer la classe avant de les utiliser 

Depuis PHP 5, il est imperatif de declarer les classes avant de les utiliser. Aussi, nous vous conseillons de grouper 
toutes les declarations de classe en tete du programme. 
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Creation d'un objet 

Pour exploiter une classe, il faut commencer par en creer une nouvelle instance qui donne naissance 
a un objet. Pour ce faire, utilisez le mot-cle new, suivi du nom de la classe que vous souhaitez instancier. 
Vous affectez ainsi 1' objet nouvellement cree a la variable situee a gauche du signe egal (exemple : 
$cocci nel 1 e=new voi ture). Les variables peuvent etre de plusieurs types (chaine de caracteres, entier, 
decimal, booleen, tableau et objet). L'instanciation est equivalente a la declaration d'une nouvelle 
variable de type objet, dont les caracteristiques (attributs et methodes) correspondent a celles definies par 
sa classe. 

Voici un exemple de creation d'un objet et de Futilisation de ses methodes : 
// Debut du programme 

/* Instantiation de la classe voiture, creation de 1 'objet "voiture_89W75" . */ 

$voi ture_89W75=new voi ture ( "rouge") ; 

/* A partir d'ici, 1 'objet "$voiture_89W75" existe. */ 

echo "Je viens d'acheter une superbe voiture". $voiture_89W75->couleur."<br>"; 
echo "et, au debut, sa vitesse est de" .$voiture_89W75->vitesse. "km/h<br>" ; 
for ($i=0;$i<5;$i++) 
{ 

echo "j'accelere encore <br>"; 
$voiture_89W75->accel erer( ) ; 
} 

echo "sa vitesse est maintenant de" .$voiture_89W75->vitesse. "km/h<br>" ; 
for ($i=0;$i<5;$i++) 

{ 

echo "je freine encore <br>"; 
$voiture_89W75->f reiner( ) ; 
} 

echo "sa vitesse est maintenant de" .$voiture_89W75->vitesse. "km/h<br>" ; 
// Fin du programme 

Passez a la pratique et saisissez le code de la declaration de la classe voiture (voir figure 13-1) puis 
celui du petit programme ci-dessus (voir figure 13-2), qui permet de creer un objet et d'utiliser ses 
methodes et proprietes dans une page PHP nominee maVoiture.php. 



Afficher toutes les proprietes d'un objet 

De meme qu'il est possible d'afficher toutes les variables d'un tableau avec la fonction pri nt_r( ), il est possible 
d'afficher les differentes proprietes d'un objet a I'aide de la fonction var_dump( ) en indiquant en argument le nom 
de I'objet concerne. Comme pour la fonction print_r( ), I'usage de cette fonction est appreciable lors de la mise 
au point d'un programme afin d'afficher ponctuellement Involution des differentes proprietes d'un objet. 
Ainsi, si Ton insere I'instruction suivante : echo var_dump($voiture_89W75) ; dans le programme precedent 
apres la premiere puis la seconde boucle for (done pour une vitesse de 5 et de 0 km/h), on peut suivre Involution 
des proprietes de I'objet $voi tureJ39W75 grace aux informations suivantes affichees dans le navigateur : 
object(voiture)(2) { ["couleur"]=> string(5) "rouge" ["vitesse"]=> int(5) } 

object(voiture)(2) { ["couleur"]=> string(5) "rouge" ["vitesse"]=> int(O) } 
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class voiture 
( 

/• declaration des propcietis utllisees dans la classe •/ 

public (couleuc; 
public Svitesse; 

/* — declaration du consttucteuc de la classe "voituce" •/ 

function construct (S choix_couleut ) 

' thi s->vitesse«0 ; 

//Initialise la Vitesse a 0 pat defaut Iocs de la creation de l*objet. 
Sthis->couleut-Jchoix_couleur; 

/* La couleuc est a£ fee tee selon le peraaetre qui est passe en argument lots 
de la creation de l'objet. */ 

) 

// declaration des aethodes courunes a la classe "voiture" 

function acceleteto 
( 

ithis->vltesse++; 

//Increaente la Vitesse si on accelere. 
) 

function £reiner() 
t 

if («this->vlt«sse>0) 
{ t this->vitesse-- ; ) 

/* Deccesente la vitesse si on freine sous la condition que la vitesse 
soit positive. */ 
I 

)//fln de la classe voiture — 

?> 

<'D0CTYPE HTML PUBLIC "-//TI3C//D1D HTHL 4.01 Transiticnal//EJT 
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Figure 13-1 

Declaration de la classe dans le debut de la page maVoiture.php 

Si vous testez cette page en Web local, vous devez obtenir a l'ecran les merries informations que ci- 
dessous (voir aussi figure 13-3) : 



Je viens d'acheter une superbe voiture rouge 
et au debut sa vitesse est de 0 km/h 
j 'accelere encore 
j 'accelere encore 
j 'accelere encore 
j 'accelere encore 
j 'accelere encore 

sa vitesse est maintenant de 5 km/h 

je freine encore 

je freine encore 

je freine encore 

je freine encore 

je freine encore 

sa vitesse est maintenant de 0 km/h 
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<title>Docu»ent sons tltte</title> 
</head> 

<body> 

<M 

//Debut du ptOQtaaae 

/• Irutanciatlon de la classe "vol cute" citation de 1 ' objet "voiture_89tf75". 
(voitute_89U75"nev voitute("Eouge"> ; 

/* A pattit d'ici, I'objet "«voitucc_89tnS" exist*. •/ 

echo "Je viens d'achetet une supetbe voiture".«voicure_89W75->couieut."<bt>" 
echo ■ et, au debut, sa vi tease est de".(voltuce_89B75->vitesse."k»/h<bC>"; 
Cot ((1-0;(1<S;S1-H-) 
( 

echo ";) 1 acceiere encore <br>"; 
«voituce_89U75->acceletet ( ) ; 

) 

echo "sa Vitesse eat naintenant de". Woitute_89W75->vitesse. *xm/h<bE>"f 

I //echo vai_duBp((voituce_89V75) ; 
echo "<bt>"; 
Cot <«i-0jU<S;«i++) 
( 

echo "}e Ctelne encore <bt>"; 
« vol tute_89W7 5 ->£ telnet ( ) ; 

) 

echo "sa Vitesse eat KUntenant de ".svoiture_89U75->vitesse." ka/h<bi>"; 

J //fin du protftt**e 

I //echo vai_du»p (fivoiture_69V75) ; 

r> 

</body> 
</htad> 
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Figure 13-2 

Script de creation des objets et d 'utilisation des proprietes et methodes place dans la page maVoiture.php 
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Figure 13-3 

Informations affichees dans le navigateur lors du test de la page maVoiture.php 
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Inclusion de classes externes 

Dans Fexemple precedent, la declaration de la classe et son utilisation (pour creer un objet) sont inte- 
grees dans un seul et meme fichier maVoi ture . php. Cependant, en pratique, il est preferable d'enregis- 
trer les declarations des differentes classes dans un ou plusieurs fichiers externes (s'il y a plusieurs 
fichiers, ils forment une bibliotheque de classes qu'il est possible d'organiser par themes). Une 
convention judicieuse de nommage de ces fichiers consiste a leur ajouter l'extension class. php afin 
de conserver les avantages des extensions PHP (en cas d'appel du fichier, le code source n'est pas 
visible...) tout en indiquant qu'il s'agit d'un fichier de classe et qu'il est structure pour etre appele 
par un autre fichier et pas pour un usage autonome. 

Ainsi, en enregistrant les definitions de classe dans des fichiers externes, il est aise de reutiliser une 
meme classe dans d'autres pages PHP. Pour disposer d'une classe dans une page PHP, il suffit d' ajouter 
une fonction includeO en tete du fichier (exemple : incl ude( "voiture. class. php") comme dans 
Fexemple ci-dessous. 



A noter 

Contrairement aux classes externes ActionScript, les fichiers de classes PHP peuvent regrouper plusieurs decla- 
rations de classe dans un meme fichier. Le nom attribue au fichier externe n'est pas obligatoirement celui de la 
classe (meme si e'est quelquefois pratique comme dans I'exemple ci-dessous). 



Dans cet exemple, la declaration de la classe voiture a ete effectuee au prealable dans un fichier 
nomme voiture. class. php. Le script suivant montre comment inclure celui-ci dans la page 
ma VoitureAvec Include, php afinde creer des objets voiture de la meme maniere que dans la page mavoi- 
ture.php presentee au debut de ce chapitre (voir figure 13-4) : 

<?php 

// Debut du programme 

// INCLUSION DE LA CLASSE EXTERNE 
incl ude( "voiture. cl ass .php" ) ; 

/* Instanciation de la classe voiture, creation de 1 'objet "voiture_89W75" . */ 

$voiture_89W75=new voi ture ( "rouge" ) ; 

/* A partir d'ici, 1 'objet "$voiture_89W75" existe. */ 

echo "Je viens d'acheter une superbe voiture". $voiture_89W75->couleur."<br>"; 
echo "et, au debut, sa vitesse est de" .$voiture_89W75->vitesse. "km/h<br>" ; 
for ($i=0;$i<5;$i++) 
{ 

echo "j'accelere encore <br>"; 
$voiture_89W75->accel erer( ) ; 

} 

echo "sa vitesse est maintenant de" .$voiture_89W75->vitesse. "km/h<br>" ; 
echo "<br>"; 
for ($i=0;$i<5;$i++) 
{ 

echo "je freine encore <br>"; 
$voiture_89W75->freiner( ) ; 
} 

echo "sa vitesse est maintenant de" .$voiture_89W75->vitesse. " km/h<br>"; 

// Fin du programme 

?> 
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Figure 13-4 

Declaration de la 
classe voiture dans 
unfichier externe 
nomme 

voiture. class.php 



Figure 13-5 

Script d'inclusion 
de la classe (a Vaide 
de V instruction 
inciude( "voiture. class 
.php")) dans la 
pagetna VoitureAvecIn 
elude. php 
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Creation d une sous-classe 

On declare une sous-classe comme une classe (class nom_sous_cl ass) mais en ajoutant le mot-cle 
extends et le nom de la classe mere dont elle depend (exemple : class camionnette extends 
voiture). Nous vous proposons d'illustrer ce nouveau concept avec l'exemple ci-dessous, qui permet 
de creer la sous-classe camionnette, qui herite de tous les attributs et methodes de la classe voiture. 
Outre cet heritage, la sous-classe est dotee d'un attribut supplementaire concemant le volume de son 
chargement ($vol ume_charge), calcule a l'aide de parametres passes en argument lors de son instan- 
tiation ($haut_charge, $1 arg_charge, $1 ong„charge) : 

Les declarations de la classe et de la sous-classe peuvent etre inserees dans un meme fichier ou dans 
deux fichiers differents (voir figure 13-6) Dans ce cas une double inclusion doit etre ajoutee dans le 
script utilisant la sous-classe (voir figure 13-7). 

// Declaration de la classe 

class voiture 
f 

public $couleur; 
public $vitesse; 

function const ruct($choix_coul eur) 

{ 

$this->vitesse=0; 

$thi s->couleur=$choix_coul eur; 

} 

function accel erer( ) 
{ 

$this->vitesse++; 
} 

function freinerO 
{ 

if ($this->vitesse>0) ($this->vitesse--;) 
} 

} 

// Declaration de la sous-classe camionnette 

class camionnette extends voiture 
f 

/* Declaration des proprietes ajoutees (volume de chargement) */ 

public $volume_charge; 

/* Declaration du constructeur de la sous-classe camionnette */ 

function construct($choix_couleur,$haut_charge,$larg_charge,$long_charge) 

{ 

$thi s->vol ume_charge=$haut_charge*$l arg_charge*$l ong_charge ; 
/* Initialise la dimension du volume de chargement lors de la creation 
de 1 'objet */ 
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parent: : construct($choix_couleur) ; 

/* Passage du parametre $choix_couleur a la classe mere voiture */ 



// Debut du programme 

$camionnette_25HH75=new camionnette ("rouge ",1.5, 1.2,2); 

/* Creation de 1 'objet camionnette_25HH75 (appelee aussi instanciation) et passage des 
parametres couleur, hauteur, largeur et longueur du volume de chargement de la 
camionnette.*/ 

echo "Je viens d'acheter une superbe camionnette "; 

echo $camionnette_25HH75->couleur. "<br>" ; 

echo " avec un volume de " . $camionnette_25HH75->vol ume_charge. " metres cube<br>"; 
echo " Au debut sa Vitesse est de ". $camionnette_25HH75->vitesse. "km/h<br>"; 
for ($i=0;$i<5;$i++) 

{ 

echo "j'accelere encore <br>"; 
$camionnette_25HH75->accelerer( ) ; 
} 

echo "sa Vitesse est maintenant de ".$camionnette_25HH75->vitesse. " km/h <br>"; 
for ($i=0;$i<5;$i++) 
{ 

echo "je freine encore <br>"; 
$camionnette_25HH75->freiner( ) ; 
} 

echo "sa vitesse est maintenant de ". $camionnette_25HH75->vitesse. " km/h <br>"; 
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//declaration de la sous-classe camionnette 

class camionnette extends voiture 
1 

/■ — -declaration des ptopnetes ajouties (volume de chargement) "/ 

public (voluae_chaige; 

/• declaration du constructeur de la sous classe camionnette V 

function construct (Schoix_couleuE,«haut_charge,«larg_charge,<long_charge) 

< 

Sthis->volu»e_charge=«haut_charge , <lar((_chatge , «lon5r_charoe; 

f* initialise la dimension du volume de chargement Iocs de la creation 

de 1 'objet •/ 
parent: : construct(Schoix_couleur) ; 

/* passage du parametre (choix couleur a la classe mere voiture "/ 
> 
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Figure 13-6 

Declaration de la sous-classe dans un second fichier externe camionnette. class. php 
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<head> 

<uca http-equlv-" Content-Type" content-"text/htal; chaEset-iso-8859-l"> 
<title>Docuaent sons titte</title></headXbody> 



include ( "vol tute. class. php") , 



include ("caalonnette. class, php' 



} 2 



tcamionnette_25HH75»neu caaionnette ("touge", 1 . 5,1. 2,2) ; 

/* creation de l'objet ca»ionnette_2 SHIPS (appelee eussi instanclation) */ 
echo "Je vlens d' ache ten une superbe caaionnette "J 
echo 5ca»ionnette_25HH75->couleur."<bc>"; 

echo " avec un volune de ".(ca>ionnette_25HH75->volu*e_chatcje." aetces cube<bE>" 
echo " Au debut sa Vitesse est de ". Jca»ionnette_25HH75->vitesse. "kB/bxbO"; 
fot (Ji-0;U<5;«i++) 
I 

echo "3'accelete encore <br>"; 
Scanionnette_2SHH7S->acceleEet ( ) ; 
) 

echo "so vitesse est taintenant de ".Cca»ionnette_25HH7S->vite3se. " k»/h <bt>"; 
for («i-0;«i<5;«i++) 
I 

echo "Je freine encore <br>"; 
*ca»ionnette_25HH75->£reiner () ; 
) 

echo "sa vitesse est maintenant de ". 5ca»ionnette_25HH75->vitesse. " lt»/h <br>" 
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Figure 13-7 

Script avec une double inclusion (de la classe voiture : repere.l et de la sous-classe camionnette : repere.2) place 
dans la page maCamionnette.php. 



Si vous testez cette page en Web Local, vous devez obtenir a l'ecran les memes informations que ci- 
dessous (voir figure 13-8) : 

Je viens d'acheter une superbe camionnette rouge 
avec un volume de 3.6 metres cube 
Au debut sa vitesse est de 0 km/h 
j 'accelere encore 
j 'accelere encore 
j 'accelere encore 
j 'accelere encore 
j 'accelere encore 

sa vitesse est maintenant de 5 km/h 
je freine encore 
je freine encore 
je freine encore 
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je freine encore 
je freine encore 

sa vitesse est maintenant de 0 km/h 
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Figure 13-8 

Informations affichees dans le navigateur lors du test de la page maCamionnette.php 
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Dans le chapitre 7 consacre a la syntaxe d' ActionScript, nous avons presente les classes Flash inte- 
grees. Elles sont exploitables directement sans qu'il soit necessaire de les declarer au prealable, mais 
leur action et leur nombre sont limites. II vous faudra sou vent developper vos propres classes afin 
qu' elles correspondent exactement aux fonctionnalites requises dans un projet. Dans ce cas, la solution 
consiste a creer des classes personnalisees. 

Declaration d'une classe simple 

Un fichier externe .as par classe 

En ActionScript 2.0, les lignes de code qui definissent une classe doivent etre enregistrees dans un 
fichier externe portant F extension .as. Chaque classe doit etre declaree dans un fichier different. 
Le fichier de declaration d'une classe doit porter exactement le meme nom que la classe correspon- 
dante. Ainsi, si vous desirez creer une classe voiture, le fichier contenant les lignes de code de sa 
declaration devra obligatoirement s'appeler voiture. as. Pour creer un fichier externe .as, vous 
pouvez utiliser un editeur de code externe (un simple Bloc -notes convient) ou Fediteur integre dans 
l'interface Flash (menu Fichier puis Nouveau et Fichier ActionScript) qui propose une assistance a la 
redaction (Attention ! Fediteur de fichier externe Flash n'est disponible que pour les interfaces auteur 
Flash Professionnel 8). 
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Chargement des classes dans le SWF 

Lors de la publication du document, le compilateur Flash recherche la presence d'objets 
personnalises dans le code. S'il en identifie, il essaie de charger le fichier .as correspondant afin 
d'integrer son code dans le SWF final. II est done indispensable que le fichier de la classe soit 
accessible au moment de la publication, mais sa presence n'est plus utile lors de la lecture du 
SWF par Flash Player, puisque les scripts de la classe ont ete integres au SWF. Par defaut, le 
fichier de la classe doit se trouver dans le meme repertoire que le document Flash au moment de 
la publication mais nous verrons plus loin qu'il est possible de definir d'autres repertoires pour 
les fichiers de classes a l'aide des chemins de classe. 



Syntaxe de la definition d'une classe 

La definition d'une classe commence par le mot-cle class, suivi du nom de la classe (exemple : 
class voiture) et, comme pour les fonctions utilisateur, d'un bloc d'instructions delimite par des 
accolades : 

class voituref 
) 



Methodes et proprietes 

A l'interieur des accolades d'une definition de classe, on indique ensuite ses proprietes (en utilisant la 
meme syntaxe que pour la declaration d'une variable : var coul eur : Stri ng, par exemple) et ses methodes 
(en utilisant la meme syntaxe que pour la declaration d'une fonction : function accel erer( ) {...}, par 
exemple). 



A noter 

Les parentheses des methodes permettent de passer des parametres afin de personnaliser leur appel. Dans le cas 
du typage strict, les variables correspondant a ces parametres doivent etre declarees et typees dans les parenthe- 
ses avant d'etre utilisees au sein de la methode (function voiture(choix_couleur:String)). Si une 
methode ne comporte aucun parametre, il faut ajouter le mot-cle Void entre les parentheses de la declaration de 
la methode (function accelerer(Void)). Enfin, si un resultat est retourne a l'aide de Instruction return, il 
est possible d'ajouter son type apres les parentheses de la fonction (function maMethode(monParame- 
tre:String):Number {....return monResul tat ; } ). 



Le constructeur 

L'instanciation d'une classe se fait en appelant une methode particuliere nommee constructeur. Cette 
methode doit porter le meme nom que la classe (soit pour notre exemple : voiture( )). II est d'usage 
de transmettre des parametres par les arguments de la methode constructeur pour configurer les 
proprietes par defaut du futur objet lors de l'instanciation (dans notre exemple, la couleur sera definie 
des l'appel du constructeur: voitureC'rouge")). 
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Dans l'exemple ci-dessous, nous allons declarer la classe voiture, puis l'enregistrer dans un flchier 
voiture.as situe dans le meme repertoire que F animation Flash : 

// Declaration de la classe dans le fichier voiture.as 

class voiture 
{ 

II Declaration des proprietes utilisees dans la classe 

var couleur:String; 
var vitesse: Number; 

II Declaration du constructeur de la classe "voiture" 

function voiture(choix_couleur:String) 
{ 

vitesse=0; 

// Initialise la vitesse a 0 par defaut lors de la creation de 1 'objet. 
coul eur=choix_couleur; 

// La couleur est affectee selon le parametre qui est passe en argument lors de la 
^creation de 1 'objet. 

} 

II Declaration des methodes communes a la classe "voiture" 

function accel erer(Void) 
{ 

vitesse++; 

// Incremente la vitesse si on accelere. 
} 

function freiner(Void) 

{ 

vitesse-- ; 

// Decremente la vitesse si on freine a condition que la vitesse soit positive 

} 

}//fin de la classe voiture 



Creation d'un objet (instanciation) 

Pour exploiter une classe, il faut commencer par creer une nouvelle instance (l'objet). En typage 
strict, la syntaxe d' instanciation doit commencer par la declaration de l'objet a creer avec le type de 
la classe dont il sera l'image (par exemple, si Ton desire creer un objet cocci nel 1 e issu de la classe 
voiture, la syntaxe sera la suivante : var cocci nel 1 e: voiture ). Cette premiere declaration doit etre 
suivie du mot-cle new, puis du nom de la classe que vous souhaitez instancier. Vous affectez ainsi 
l'objet nouvellement cree a la variable situee a gauche du signe egal (exemple: var cocci - 
nellervoiture =new voiture). 

Voici un exemple de creation d'un objet (ce code est saisi dans l'image cle 1 du scenario principal) : 
// Debut du programme 

// Instanciation de la classe voiture pour creer un objet "voiture_89W75" . 
var voiture_89W75:voiture=new voituret "rouge" ) ; 
// A partir d'ici, l'objet "voiture_89W75" existe. 
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Second sens du mot-cle constructeur en ActionScript 

Dans le chapitre consacre a I'introduction a la POO, nous avons defini le constructeur comme etant une fonction au 
sein d'une definition de classe qui porte le meme nom que la classe et qui est appelee lors de I'instanciation. 
Cependant, en ActionScript, le terme constructeur peut egalement etre utilise lorsque vous instanciez un objet en 
fonction d'une classe particuliere (integree ou personnalisee). Par exemple, les instructions suivantes sont des 
constructeurs des classes Array (classe integree) et voiture (classe personnalisee) : 

var monTableau:Array = new ArrayO; 

var voiture_89W75:voiture=new voiture( "rouge" ) ; 



Utilisation des methodes et proprietes d'un objet 

Une fois que F objet existe, il est possible d' exploiter ses methodes et de manipuler (modifier ou refe- 
rencer) ses proprietes. Pour cela, utilisez la syntaxe pointee, comme avec les objets integres. 

Par exemple, les lignes de code suivantes doivent etre saisies a la suite des precedentes (instruction 
d'instanciation) dans l'image cle 1 du scenario principal : 

trace("Je viens d'acheter une superbe voiture"+voiture_89W75.couleur) ; 
trace("et, au debut, sa vitesse est de "+voiture_89W75.vitesse+" km/h"); 
for (var i :Number=0;i<5;i++) 
{ 

trace( "j 'accel ere encore"); 
voiture_89W75.accelerer( ) ; 
} 

traceCsa vitesse est maintenant de "+voiture_89W75.vitesse+" km/h"); 
for ($i=0;$i<5;$i++) 
{ 

trace("je freine encore"); 
voiture_89W75.freiner( ) ; 

} 

trace("sa vitesse est maintenant de "+voiture_89W75.vitesse+"km/h") ; 
// Fin du programme 

Application pratique 

Nous vous suggerons maintenant de passer a la pratique. 
Creation de la classe externe 

Commencez par saisir les lignes de code de la declaration de la classe voiture (reportez-vous au 
script de l'exemple illustrant le constructeur) dans un fichier voiture. as et enregistrez-le dans un 
repertoire specifique (par exemple : FLASH-POOUestlnstanciation) (voir figure 14-1). 

Creation du document principal 

Saisissez ensuite le script d'instanciation et d'utilisation des proprietes et methodes (reportez-vous au 
petit programme precedent, voir figure 14-2) dans l'image cle 1 du document Flash principal et enre- 
gistrez-le sous le nom maVoiturel.fla dans le meme repertoire que le fichier de classe externe (par 
exemple : FLASH-POOUestlnstanciation). 
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Figure 14-1 

Script de la classe 
voiture saisie dans le 
fichier externe 
voitu.re.as avec 
I'iditeur de fichier 
integre d Flash 
(uniquement avec la 
version Pro ; si vous 
ne disposez pas de 
cette version, utilisez 
I'iditeur externe de 
votre choix). 
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// -declaration des Mthodea comwunes * le class* "voiture" 

function accelerer (Voidi ( 
Vitesse**; 
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Vitesse--; 
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Figure 14-2 

Programme saisi 
dans I 'image cle 1 
de V animation 
maVoiturel.fla 
utilisant la classe 
voiture. Ce fichier 
doit etre enregistre 
dans le mime 
repertoire que la 
classe voiture. as. 
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Test de I'animation 

Si vous testez I'animation principale maVoiturel.swf, vous devez obtenir dans le panneau Sortie 
(voir aussi figure 14-3) les memes informations que celles indiquees ci-dessous : 

Je viens d'acheter une superbe voiture rouge 
et au debut sa Vitesse est de 0 km/h 
j 'accelere encore 
j 'accelere encore 
j 'accelere encore 
j 'accelere encore 
j 'accelere encore 

sa vitesse est maintenant de 5 km/h 

je freine encore 

je freine encore 

je freine encore 

je freine encore 

je freine encore 

sa vitesse est maintenant de 0 km/h 
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viens d'acheter une superbe voitureroucje 
et, au debut, sa vitesse est de 0 km/h 
accelere encore 
J* accelere encore 
accelere encore 
J* accelere encore 
}' accelere encore 

sa vitesse est maintenant deS kn/h 
Je freine encore 
Je freine encore 
Je freine encore 
je freine encore 
Je freine encore 

sa vitesse est maintenant de 0 km/h 





Figure 14-3 

Informations affichees dans le panneau de sortie lors du test de I'animation maVoiturel.swf. 



ActionScript et la programmation orientee objet (POO) 

Chapitre 14 



Verifier au prealable la disponibilite du f ichier externe 

Le fichier externe de la classe (exemple : voiture. as) est integre dans I'animation principale au moment de la 
compilation du fichier SWF (lors de la publication ou du test de I'animation dans I'environnement de controle de 
Flash, par exemple). II taut done imperativement s'assurer avant la compilation de la disponibilite du fichier de 
classe dans le meme repertoire que celui de I'animation ou dans le repertoire du chemin de classe (cette seconde 
alternative est presentee plus loin). 



Comment modifier les proprietes d'un objet ? 

De meme qu'il est possible de modifier facilement les proprietes d'un objet Flash integre par une 
simple affectation de la nouvelle valeur, les proprietes de l'objet que nous venons de creer peuvent 
elles aussi etre modifiees (voir figure 14-4) : 

// Code saisi a la suite des instructions precedentes dans 1 'image cle 1 du scenario principal 
trace( "maintenant j'ai fait repeindre ma voiture en vert"); 
voiture_89W75.couleur="vert" ; 

traceCsa nouvelle couleur est done : "+voiture_89W75.couleur) ; 

L' execution de ce script affiche le message ci-dessous dans le panneau Sortie : 

maintenant j'ai fait repeindre ma voiture en vert 
sa nouvelle couleur est done : vert 




Figure 14-4 

Ajout du script de modification de la valeur de la propriete couleur, puis enregistrement dans un second fichier 
principal maVoiture2.fla. En bas et a gauche, on peut voir le panneau de sortie contenant les informations 
affichees lors du test de V animation maVoiture2.swf. 
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Regies d'usage des classes 
Documentez vos declarations de classe 

Comme lors de la creation d'une fonction, il est recommande de commenter largement les lignes de 
code de definition d'une classe. Deux types de commentaires existent. Le premier correspond a des 
commentaires internes a la classe, qui doivent preciser toutes les specificites des structures, variables 
et methodes utilisees. Le second conceme les commentaires places dans l'en-tete de la classe, qui 
doivent indiquer les domaines d' utilisation de la classe, ses precautions d'usage eventuelles, ainsi 
que la liste des methodes et proprietes qui pourront etre exploites par l'objet apres instanciation. 
Theoriquement, si les commentaires d'en-tete sont suffisants, un programmeur devrait pouvoir utiliser 
la classe sans avoir a analyser les scripts de celle-ci. 

Exemple de commentaires d'en-tete d'une classe : 

/* 

Norn de la classe : voiture 

Usage de cette classe : classe a usage pedagogique pour 1 'apprentissage des concepts 

*des classes Flash. 

Auteur : JM Defrance 

Date de mise a jour : 1-09-2006 

Version : Flash 8 



Methode : 

voiture(couleur) : constructeur avec 1 argument qui permet de configurer la couleur de la voiture 
accelererO : permet d'incrementer la Vitesse de l'objet 
freinerO : permet de decrementer la vitesse de l'objet 



Utilisez le typage strict dans vos classes 

Meme s'il n'est pas obligatoire d'utiliser le typage strict pour declarer les differents elements d'une 
classe, il est fortement recommande de le faire. Dans le chapitre 7 consacre aux bases du langage 
ActionScript, nous avons enumere les avantages du typage strict dans la redaction de vos scripts. Ces 
avantages sont egalement applicables aux classes : 1' usage du typage strict dans la declaration d'une 
classe permet d'eviter de nombreuses erreurs lors de son exploitation. 




Proprietes : 

couleur : String - couleur de la voiture (initialisee par le constructeur) 
vitesse : Number - memorise la vitesse de l'objet 



*/ 
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Exemple : 



// 



Declaration des proprietes utilisees dans la classe 



var couleur: String; 
var vitesseiNumber; 

II Declaration du constructeur de la classe voiture 

function voiture(choix_coul eur : String) 



Les chemins de classe et les paquets 



Dans les exemples de classe presentes precedemment, le fichier de classe (voi ture . as) se trouve dans 
le meme repertoire que le document Flash au moment de la publication (avant d'etre inclus dans le 
SWF). Cependant, il existe d'autres alternatives pour enregistrer les fichiers de classes. Par la suite, 
nous nommerons chemin de classe le repertoire dans lequel se trouvent ces fichiers. 

Chemin de classe global 

Un chemin de classe global est caracterise par le fait qu'il est commun a tous les documents Flash 
publies. II correspond a deux repertoires differents. L'un est le repertoire dans lequel se trouve le 
document Flash lors de sa publication (c'est ce chemin de classe que nous avons utilise jusqu'a 
present). Le deuxieme est le repertoire dans lequel sont placees toutes les classes integrees de 
Flash. Par exemple, sous Windows XP, ce repertoire se trouve dans le dossier ci-dessous (voir 
figure 14-5) : 

| C:\Program Files\Macromedia\Flash 8\fr\First Run\Classes 




Conrwnds 



O D«t«Typ*s 
fa Dotation 



< 



> 



Figure 14-5 

Repertoire du chemin de classe global sous Windows XP 
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Si vous desirez regrouper vos fichiers de classes personnalisees dans un repertoire specifique, 
vous pouvez enregistrer ce chemin de classe dans la fenetre des parametres d'ActionScript 
(menu Edition, Preferences, onglet ActionScript puis cliquez sur le bouton Parametres, voir 
figure 14-6). 
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Figure 14-6 

Ajout d'un chemin de classe global specifique 



Chemin de classe lie au document 

Dans certain cas, il peut etre interessant de definir un chemin de classe uniquement pour le docu- 
ment Flash courant. La solution consiste alors a ajouter dans ce document un chemin de classe lie 
au document (et done specifique a ce dernier). Par defaut, les fichiers FLA ne comportent aucun 
chemin de classe lie. Pour ajouter un ou plusieurs chemins de classe lies a un document FLA, il 
suffit de les configurer dans les parametres de publication depuis la fenetre parametres d'Action- 
Script (menu Fichier, Parametres de publication, onglet Flash puis cliquez sur le bouton Parametres, 
voir figure 14-7). 
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Figure 14-7 

Ajout d'un chemin de classe lie a un document FLA specifique 



Les paquets 

On appelle paquets tous les repertoires places dans le repertoire du chemin de classe. Les paquets 
contiennent des fichiers de classes (voire des sous-paquets) et permettent au programmeur d' organiser 
logiquement ses fichiers de classes afin de les localiser facilement. 

Le chemin de fichier de la classe 

La syntaxe de declaration d'une classe organisee en paquets doit tenir compte du repertoire dans 
lequel le fichier de classe est enregistre. En effet, le chemin menant au fichier de classe (a partir du 
point de reference correspondant au repertoire du chemin de classe declare) doit etre ajoute apres le 
mot-cle cl ass. 

Lexemple ci-dessous correspond a la declaration de la classe voiture enregistree dans un repertoire 
nomme classePerso, lui-meme place dans le repertoire Mes documents\Flash de l'ordinateur. 
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Figure 14-8 

Exemple de paquets de classes places dans le chemin de classe global 

Le chemin du repertoire mes documents a ete ajoute au prealable en tant que chemin de classe global 
a Faide de la fenetre des parametres ActionScript (revoir la procedure detaillee precedemment : 
figure 14-6). 

// Declaration de la classe dans un paquet 

class classePerso. voiture 
{ 

II Declaration des proprietes utilisees dans la classe 

var couleur:String; 
var vitesse:Number; 

// Declaration du constructeur de la classe "voiture" 

function voiture (choix_coul eur: String) 
f 

vitesse=0; 

// Initialise la vitesse a 0 par defaut lors de la creation de l'objet. 
couleur=choix_couleur; 

// La couleur est affectee selon le parametre qui est passe en argument 
*lors de la creation de l'objet. 

} 

// Declaration des methodes communes a la classe voiture 

function accelerer( ) 
f 

vitesse++; 

// Incremente la vitesse si on accelere. 
} 

function freinerO 
f 

vitesse--; 

// Decremente la vitesse si on freine a condition que la vitesse 
*»soit positive 

} 

} // Fin de la classe voiture 
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L' instruction d'instanciation de la classe dans le document Flash doit, elle aussi, tenir compte du fait 
que la classe se trouve dans un paquet. Le chemin du fichier de classe doit etre ajoute devant le type 
de donnees et devant le constructeur comme dans l'exemple ci-dessous : 

var voiture_89W75:classePerso.voiture =new classePerso.voiture( "rouge" ) ; 

Linstruction import 

Si le chemin de fichier de classe est long et les creations d'objets nombreuses, la saisie du chemin de 
fichier a chaque instanciation peut vite devenir fastidieuse. Heureusement, il est possible de s'abstenir 
de rappeler le chemin de fichier de classe a chaque instanciation. 

Pour cela, il faut utiliser l'instmction import, suivie du chemin de fichier et du nom de la classe. II est 
ensuite possible de creer autant d'objets que Ton souhaite sans devoir rappeler le chemin du fichier 
de classe. II faut toutefois savoir que ces instanciations simplifiees ne sont possibles que si elles se 
trouvent dans la meme image cle que l'instraction import. 

Exemple : 

import classePerso.voiture ; 
var voiture_89W75:voiture =new voitureC'rouge"); 
var voiture_54T60:voiture =new voiture( "verte" ) ; 
var voiture_86H68:voiture =new voitureC'bleue"); 

Le repertoire d'un paquet contient souvent plusieurs fichiers de classes. Dans ce cas, utilisez le 
caractere * a la place du nom de la classe, afin d'importer en une seule operation tous les fichiers de 
classes qui s'y trouvent. 

Dans l'exemple ci-dessous, tous les fichiers de classes contenus dans le repertoire cl assePerso seront 
importes dans le document Flash : 

import classePerso.* ; 



Declaration d'une classe dynamique 

Si nous poursuivons notre comparaison avec les classes integrees de Flash, nous pouvons nous 
demander s'il est possible d'ajouter de nouvelles proprietes a l'objet sans modifier sa classe origi- 
nelle (comme c'est le cas avec les classes integrees dynamiques telles que MovieClip, par exemple). 
Admettons par exemple que nous desirons ajouter une propriete opti on a notre objet et lui attribuer la 
valeur « metallisee » sans modifier la declaration de la classe. On serait alors tente d'inserer la ligne 
de code suivante : 

voiture_89W75.option="metal 1 isee" ; 

Cependant, si nous testons 1' animation modifiee, un message d'erreur nous indique qu'il n'existe aucune 
propriete nommee opti on. En effet, il nous faut d'abord rendre dynamique la classe originelle en ajoutant 
simplement le mot-cle dynami c au debut de sa declaration comme dans le debut de code ci-dessous : 

dynamic class voiture 
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Dans ce cas, si on ajoute les deux lignes de code suivantes a la suite du programme place dans 
l'image 1 du scenario principal (voir figure 14-9) : 

voi ture_89W75.option= "metal 1 i see" ; 

trace("j'ai aussi pris 1 'option : "+voiture_89W75. option) ; 
et si Ton teste l'animation modifiee, le message suivant est affiche dans le panneau Sortie : 
j'ai aussi pris 1 'option : metallisee 
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\ Assotar* de script 



// Inst anciat ion de la classe "voiture" pour creer un ■ 
var voiture_89V7S:voiture • new voiture ("rouge") j 
// k partir d' lei, l'objet "voiture_B9U"75" existe. 
tracefJe viens d* acheter une superbe voiture"+voitu 
trace ( " et, au debut, sa Vitesse est de "+volture_89 
for (var 1 - 0; 1<5; i++) ( 

trace ("j ' accelere encore") t 
votture_89¥75.accelecer () ; 

trace ("sa Vitesse est maintenant de"*voiture_89W75.v 
for (d-0; IMSj ti++) ( 

trec«("jc freine encore "); 
volture_89V7S. f relner () ; 

traceCsa Vitesse est maintenant de ~+VOlturt_89IT7S. 
trace ( "maintenant J'ai fais repeindre ma voituce en 
voiture_89W7S. couleur " "vert"j 

tracefsa nouvelle couleur est done : "4voiture_8907 
voiture_89tf75. option ■ "metallsee"; 

trace ("j ' ai aussi pris l'option : ~+-voiture_69tT75 . on 



Figure 14-9 

Script d ajouter pour tester I 'utilisation d'une classe dynamique (Attention ! Ilfaut au prealable avoir modifie 
la declaration de la classe voiture en ajoutant le mot-cle dynamic). 



Methodes get et set 

Si nous reprenons notre exemple de classe voiture, nous avons vu qu'il etait possible de regler la 
propriete vitesse par l'appel de methode accelerer( ) ou f reiner( ) et qu'il etait egalement possible 
de la modifier directement et sans restriction par une simple instruction d' affectation, comme dans 
F exemple ci-dessous : 

voiture_89W75. vitesse =50; 
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Si vous desirez limiter la plage d'affectation de la propriete vitesse en interdisant les vitesses infe- 
rieures a 0 ou en fixant la vitesse maximale a 90, tout en conservant la possibilite de la modifier par 
une simple affectation, il faut utiliser les methodes get et set. 

Ces methodes permettent de gerer Faffectation (set) ou la recuperation (get) d'une propriete de 
classe en conservant la meme syntaxe que celle utilisee pour la manipulation classique d'une 
propriete. C'est particulierement interessant si plusieurs instructions d'affectation ou de recuperation 
ont deja ete inserees dans le document Flash. L'ajout des methodes get et set dans la classe peut 
s'effectuer sans modification des instructions presentes dans le document Flash. 



Syntaxe du set 

La syntaxe de declaration d'une methode set (affectation) est la suivante : 

function set vitesse(v:Number) 
(... utilisation du parametre v passe en argument} 

Cette syntaxe est identique a la syntaxe traditionnelle des methodes, hormis le fait que le nom de la 
methode est compose du mot-cle set, suivi de l'identifiant qui sera employe en tant que pseudo- 
propriete dans le script d'appel. 

Par exemple, si le script d'appel est voiture_89W75.vitesse=50, la syntaxe de la declaration sera 
alors : set vitesse(v:Number). Le script d'appel n'est pas structure selon la syntaxe usuelle de 
l'appel d'une methode : sa syntaxe est semblable a celle d'une simple affectation de propriete 
(voiture_89W75.vitesse=50). Si cela peut paraitre destabilisant, c'est neanmoins tres pratique: si 
vous ajoutez une methode set dans un programme existant, il ne sera pas necessaire de modifier 
toutes les affectations de la pseudo-propriete existantes. 

Lunique parametre de la methode permet de recuperer la valeur affectee a la pseudo-propriete lors de 
l'appel afin de 1' exploiter au sein de la methode (exemple : voiture_89W75.vitesse=50 ; dans ce cas, 
le parametre v de la methode recupere la valeur 50). 



Syntaxe du get 

La syntaxe de la methode get (recuperation) est la suivante : 

function get vitesse():Number { 

return nouvelleVitesse; 

> 

La syntaxe est identique a la syntaxe traditionnelle des methodes, hormis le fait que le nom de la 
methode est compose du mot-cle get, suivi de l'identifiant qui sera employe en tant que pseudo- 
propriete dans le script d'appel (soit vitesse dans notre exemple). Une methode get n'a pas de para- 
metre mais contient une instruction return qui permet de retourner une variable geree en interne 
(nouvelleVitesse dans l'exemple ci-dessus). 

Pour appeler cette methode depuis un script, il suffit d' utiliser la meme syntaxe que pour une simple 
recuperation de propriete avec l'identifiant de la methode (soit vitesse dans notre exemple) a la place 
du nom de la propriete que Ton desire recuperer (exemple : maVariable=voiture_89W75. vitesse;). 
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Dans le cas de l'exemple precedent, la valeur de la variable interne nouvelleVitesse est retournee 
(grace a Finstruction return) et sera affectee a la variable maVariable. 

Application pratique 

Dans l'exemple ci-dessous, nous avons ajoute deux methodes get et set dans la declaration de la 
classe (enregistree dans un fichier de classe venture. as dans le repertoire FLASH -POOUestGet) afin de 
limiter la plage d'utilisation de la propriete vi tesse de 0 a 90. Vous remarquerez que pour eviter tout 
conflit entre le nom de la variable contenant la valeur de la vitesse et celui des identifiants des metho- 
des get et set, une seconde variable interne nouvelleVi tesse a ete declaree. Toutefois, nous verrons 
dans le script d'appel que cela ne change en rien la maniere d'affecter ou de recuperer la pseudo- 
propriete vitesse de l'objet. 

Commencons par saisir la declaration de classe suivante dans le fichier voi ture .as (voir figure 14-10) : 
// Declaration de la classe 



function voiture(choix_couleur : String) 
f 

nouvelleVitesse=0; 

// Initialise la vitesse a 0 

couleur=choix_couleur; 

// La couleur est affectee 

} 

// Declaration des methodes get et set 

function set vitesse(v:Number) { 
if(v<0){ 

nouvelleVitesse=0; 
} else if(v>90) { 

nouvelleVitesse=90; 
} else { 

nouvelleVitesse^ v; 
} 

} 

function get vitesse( ): Number { 
return nouvelleVitesse; 




class voiture 



// Declaration des proprietes utilisees dans la classe 

var couleur:String; 

var nouvelleVitesseiNumber; 

// Declaration du constructeur de la classe voiture 



} // Fin de la classe voiture 
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//declaration de la classe 

c lass voiture < 

// declaration des proprietea utilisees dans la classe 

var couleur: String; 
private var nouvelleVitesse:Nurotoer; 

// declaration du constructeur de la classe "voiture" 

function voiture (choix_couleur: String) ( 
nouvelleVitesse • 0; 
//Initialise la Vitesse a 0 
couleur - choix_couleur; 
// La couleur est affectee 



// declaration des roethodes get et set 

function set vitesse (v:Number) I 
if (v<0) < 

nouvelleVitesse ■ 0; 
) else if (v>90) < 

nouvelleVitesse - 90; 
} else ( 

nouvelleVitesse - v; 

> 

function get vitesse () : Number ( 
return nouvelleVitesse; 



//tin de la classe voiture- 
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Figure 14-10 

Script de la classe enregistree dans lefichier externe voiture. as 



Pour tester cette nouvelle classe, saisissons les lignes de code suivantes dans un nouveau document 
Flash maVoiture4.fla enregistre dans le repertoire FLASH-POOUestGet. Vous remarquerez que les 
syntaxes utilisees pour appeler les methodes get et set sont identiques a celles utilisees lors de 
l'affectation ou de la recuperation d'une pseudo-propriete qui serait nommee vitesse : 

var voiture_89W75:voiture =new voitureC'rouge"); 

// A partir d'ici, 1 'objet "voiture_89W75" existe. 

traceC'Je viens d'acheter une superbe voiture"+voiture_89W75. couleur) ; 

traceCau debut la vitesse est de "+voiture_89W75. vitesse) ; 

voiture_89W75.vitesse=50; 

traceCje regie la vitesse a 50 et el 1 e est maintenant a "+voiture_89W75. vitesse) ; 
voiture_89W75.vitesse=100; 

traceCje regie la vitesse a -10 mais el 1 e est limitee a "+voiture_89W75. vitesse) ; 
voiture_89W75.vitesse=-5; 

traceCje regie la vitesse a 120 mais el 1 e est limitee a "+voiture_89W75. vitesse) ; 
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\ Assistant de script 



1 vox voiture_89W7S:voiture ■ nev voiture ("rouge") ; 

2 // A part if d' ici, l ■ objet "voiture_89W75~ existe. 

3 trace("Je viens d'acheter une superbe voiture"+voiture_89ir75.couleur) ; 

4 traceC'la vitesse cat au debut de "♦voiture 89W75 .vitesse) ; 



5 voiture_89W7S. vitesse ■ 50; 

6 trace ("je regie SO et la vitesse est maintenant de **+voiture_69U75. vitesse) ; 

7 voiture_89IT75. vitesse ■ -10; 

8 trace ("je regie -10 et la Vitesse est maintenant de "4voiture_89V75. vitesse) ; 

9 voiture_89W75. Vitesse - 120; 

10 trace("je regie 120 et la Vitesse est maintenant de "+voiture_89 u 75.viteaac) ; 



■I 




Je viens d' acheter une superbe voiturerouge 
la viteaae eat au debut de 0 



± 



}e cegle SO et la Vitesse esc maintenant de SO 
je regie -10 et la Vitesse est maintenant de 0 
]e regie 120 et la Vitesse est maintenant de 90 



Figure 14-11 

Programme du document principal enregistre dans Vintage cle 1 de I'animation maVoiture4.fla. 



Si nous testons F animation, les messages suivants s'affichent dans le panneau Sortie (voir le panneau 
de sortie de la figure 14-1 1) : 

Je viens d'acheter une superbe voiture rouge 
au debut la vitesse est de 0 

je regie la vitesse a 50 et elle est maintenant a 50 
je regie la vitesse a - 10 mais elle est limitee a 0 
je regie la vitesse a 120 mais elle est limitee a 90 



Membre private ou public 

On appelle membres les proprietes et les methodes d'une classe. Par defaut, tous les membres d'une 
classe sont accessibles depuis le document Flash dans lequel l'objet a ete cree. On dit que les 
membres sont publics (mot-cle publ i cs). 
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Cependant, dans certains cas, il est necessaire d'interdire Faeces a un membre particulier d'une 
classe. La solution consiste alors a prefixer la declaration de ce membre par le mot-cle private 
comme ci-dessous : 

private var membreInterdit:Number; 

Application pratique 

Pour illustrer Futilisation des mots-cles publ i cs et pri vate, nous allons reprendre la classe voi ture et 
y ajouter une methode qui calcule le prix de la vignette. Le prix de la vignette correspond au produit 
du nombre de chevaux-vapeur de la voiture par le prix de la taxe pour un cheval-vapeur. Cette 
deuxieme valeur est etablie initialement dans une variable interne nommee prixCheval et ne doit pas 
etre accessible en dehors de la classe (la propriete prixCheval ne peut ni etre lue ni etre modifiee, elle 
doit done etre privee). 

Afin de pouvoir creer des voitures de differentes puissances fiscales, un second parametre nbChevaux 
est ajoute dans les arguments du constructeur afin d'initialiser le nombre de chevaux-vapeur des la 
creation de Fobjet voiture (voir figure 14-12). 

Code de la declaration de la classe voiture enregistree dans un fichier voiture. as : 

// Declaration de la classe 

class voiture 
{ 



function voi tu re ( choix_couleur: St ring,choix_chevaux: Number) 

{ 

coul eur=choix_coul eur; 

// La coul eur est initialised 

nbChevaux=choix_chevaux; 

// La puissance est initialisee 

} 

// declaration des methodes 

public function calculVignette( ) 
{ 

prixVignette=nbChevaux*prixCheval ; 
// Calcule le prix de la vignette 
return prixVignette; 
} 

} // Fin de la classe voiture 

Pour tester cette classe, nous allons creer un nouveau document Flash dans lequel nous saisissons le 
code ci-dessous dans la premiere image cle du scenario principal (voir figure 14-13) : 

var voiture_89W75:voiture =new voiture("rouge",3); 
// A partir d'ici, 1 'objet "voiture_89W75" existe. 



II Declaration des proprietes utilisees dans la classe 

public var couleur:String; 
private var prixCheval : Number=20; 
public var nbChevaux:Number; 
public var prixVignette:Number; 

// Declaration du constructeur de la classe voiture 
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traceCJe viens d'acheter une superbe voiture"+voiture_89W75.couleur+" et 

*»de "+ voiture_89W75.nbChevaux+" chevaux); 

prix=voi ture_89W75.cal cul Vignette ( ) ; 

traceCle prix de la vignette est de "+prix+"euros" ) ; 
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public vac couleuc:3tcing; 
private v«r pnxCheval iNuwtoec ■ 20; 
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sees dans la cla 



■c vac nbChevaux :Nunt>cj: 
public vac pcixVignette:Nunbec; 

declaration du constcucteuc 
f unct ion voicure |choix_couleur : String, 
couleuc - choix_couleur; 
// La couleuc est imtiallsee 
nbChevaux ■ choix_chevaux; 
// La puissance est initialise* 



de la classe "voituce" 
choixchevaux : Number ) ( 
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// declaration des met nodes 

public function calculVlgnette {) ( 

pclxVignette - nbCbevaux'pcixCbeval; 

//calcul le pcix de la vignette 
ceturn prlxVlgnette; 

) 

n de la classe voituce 
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Figure 14-12 

Script de la classe avec membre prive enregistree dans lefichier externe voiture.as 



Si nous testons 1' animation et que tout fonctionne correctement, les messages suivants seront affiches 
dans le panneau Sortie (voir figure 14-13) : 

I Je viens d'acheter une voiture rouge et de 3 chevaux 
le prix de la vignette est de 60 euros 

Comme la propriete prixCheval est privee, elle ne peut plus etre manipulee en dehors de la classe. 
Pour nous en assurer, nous allons essayer de la modifier en ajoutant a la suite du programme place 
dans 1' image cle 1 la ligne de code suivante : 

voiture_89W75. prixCheval =40; 

Si nous testons de nouveau l'animation, l'erreur suivante doit etre affichee : 

Le membre est prive : acces impossible. 
voiture_89W75. prixCheval =40; 
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Figure 14-13 

Programme du document principal enregistre dans V image cle 1 de 1' animation maVoitu.re5.fla 



Membre static (variable de classe) 

Dans les exemples que nous avons presentes jusqu'a present, chaque membre d'une classe pouvait 
etre modifie individuellement afin de personnaliser les differentes caracteristiques de F objet (par 
exemple, dans la classe voiture, la propriete couleur permet de creer des objets de couleurs 
differentes : rouge, vert, etc.). 

Cependant, il est quelquefois necessaire de disposer de membres communs a toutes les instances 
d'une meme classe. Dans ce cas l'usage du mot-cle static permet de declarer un membre specifique 
de la classe comme etant « non personnalisable ». 

Par exemple, s'il s'agit d'une propriete, sa valeur sera commune a toutes les instances de la classe. Si 
cette valeur est modifiee dans un des objets issus de la classe, la nouvelle valeur se repercutera 
ensuite automatiquement dans tous les autres objets. Pour modifier ou recuperer une propriete 
static, il faut faire appel aux methodes get et set (revoir si besoin la presentation de ces methodes 
ci-dessus). 

Les membres static (proprietes et methodes) peuvent etre references directement avec le nom de la 
classe et non seulement en utilisant le nom d'une des instances de cette derniere. Dans le cas des 
methodes declarees comme static (done des methodes disposant des memes fonctionnalites dans 
toutes les instances de la classe), il est d'ailleurs obligatoire d'utiliser le nom de la classe pour les 
appeler. De meme, les methodes stati c ne peuvent manipuler que des variables prealablement decla- 
rees comme static (alors qu'une propriete static peut etre manipulee par une methode static ou 
non). 
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Par exemple, si nous declarons une methode static nommee modi f Tel ( ) dans la classe voiture, il 
faut l'appeler directement avec le nom de sa classe comme dans le code suivant : 

| voiture. modi fTel 0 ; 

et non avec le nom d'un des objets comme ci-dessous : 
voiture_89W75.modifTel () ; 



Application pratique 

Pour illustrer Futilisation du mot-cle static, nous allons reprendre la classe voiture et y ajouter une 
propriete tel Depannage qui aura pour but d'afficher le numero de telephone du service de depannage. 
Nous partons du principe que ce service de depannage est centralise et que son numero est commun 
a toutes les voitures. Pour gerer la recuperation ou la modification de cette propriete, nous utiliserons 
des methodes get et set. Ann d'eviter les conflits (entre le nom des methodes get/set et la propriete), 
une seconde variable interne tel, qui contient la valeur du numero de telephone, est creee. Ann que 
ce numero de telephone soit commun a tous les objets, cette variable tel est declaree comme stati c. 

Une fois cette nouvelle classe operationnelle, nous la testerons en modifiant le numero de telephone 
par 1' intermediate de la pseudo-propriete tel Depannage d'un des objets. Nous verifierons finalement 
que ce changement a bien ete repercute sur tous les autres objets et que tous les numeros de telephone 
des voitures ont ete actualises. 

Le script ci-dessous correspond a la declaration de la classe voiture. Dans cette classe, la variable 
interne tel est declaree comme stati c. Les methodes get et set permettent de gerer cette variable depuis 
le document Flash par recuperation (get) ou modification (set) de la pseudo-propriete 
tel Depannage (voir figure 14-14) : 

// Declaration de la classe voiture 

class voiture 
{ 

// Declaration des proprietes utilisees dans la classe 

var couleur:String; 

static var tel :Number=0140442000; 

// Declaration du constructeur de la classe voiture 

function voi ture(choix_couleur:String) 
{ 

couleur=choix_couleur; 

// La couleur est initialisee 

} 

// Declaration des methodes 

function set telDepannage(n:Number) 
{ 

tel=n; 
} 

function get tel Depannage( ): Number 
{ 

return tel ; 

} 



} // Fin de la classe voiture 
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declaration des proprietes utlllsees dans la classe 

IB .vie couleur iScting^ 



static var tel:Kunber - 0140442000; 

eur de la classe "voiture" 
function voiture (choix_couleur : String) { 
couleuE - choix_couleur; 

// La couleuc est initialised 

// declaration des methodes 

public function set telDepannage (n:Nunrfcer) ( 
tel - n; 

public function get telDepannage ( ) : Number < 
return tel; 



fin de la classe voiture- 
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Figure 14-14 

Script de la classe avec membres statiques enregistree dans lefichier externe voiture. as 



Pour tester la classe, nous devons creer un nouveau document Flash dans lequel sera place le code ci- 
dessous. La premiere partie du script cree trois objets de la classe voiture en leur attribuant une 
couleur differente, puis affiche les numeros de telephone initialises lors de Finstanciation. Cette 
partie est suivie d'une instruction qui modifie le numero en affectant a la pseudo-propriete tel Depan- 
nage la valeur du nouveau numero (en realite, cette instruction appelle la methode set tel Depannage 
qui actualise la variable interne tel). La derniere partie affiche a tour de role chacun des numeros de 
telephone des trois objets apres leur modification : 

var voiture_89W75:voiture =new voiture( "rouge" ) ; 

trace("pour joindre le depanneur de la voiture "+voiture_89W75.couleur+" composez le 

*»"+voiture_89W75.tel Depannage) ; 

var voiture_98Y75:voiture =new voitureC'verte"); 

trace("pour joindre le depanneur de la voiture "+voiture_98Y75.couleur+" composez le 

*»"+voiture_98Y75.tel Depannage) ; 

var voiture_56M75:voiture =new voiture( "bl eue" ) ; 

trace("pour joindre le depanneur de la voiture "+voiture_56M75.couleur+" composez le 
*»"+voiture_56M75.tel Depannage) ; 
// 

voiture_89W75.telDepannage=0145452222; 
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II 

traceCje modifie le tel de la voiture "+voiture_89W75.couleur) ; 

traceCdesormais, pour joindre le depanneur de la voiture "+voiture_89W75.couleur+" composez 

e "+voiture_89W75. tel Depannage) ; 
traceCdesormais, pour joindre le depanneur de la voiture "+voiture_98Y75.couleur+" composez 
*»1 e "+voiture_98Y75. tel Depannage) ; 

traceCdesormais, pour joindre le depanneur de la voiture "+voiture_56M75.couleur+" composez 
*»1 e "+voiture_56M75. tel Depannage) ; 
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\ Assistant de sorpt 



1 vac voiture_89W75:voiture ■ 

2 trace("pour joindre le depa 

3 var voiture_98Y75:voiture « 

4 tracefpour joindre le depa 

5 var voiture S6IT?5:voiture - 



new voiture ("rouge") ; 

mage de la voiture "■«voiture_89W75.couleur+" 
new voiture ("verte") ; 

tnage de la voiture "+voiture_98Y75.couleur+" 
new voiturt("bleue")j 



6 trac«("pour joindre le depannage de la voiture "+voiture_561T75. eouleurv 

H// 



; voiture_89tf75.telDepannage ■ 0145452222; 

9 trace ("je modifie le tel de la voiture "4VOlture_89V75.couleur) ; 
,0 tracefdesocmais, pour joindre le depannage de la voiture "+voiture_89U75.couleui 
tracei'desormais, pour joindre le depannage de la voiture "+voiture_98Y75.couleuj 
.2 traceCdesormais, pour joindre le depannage de la voiture "♦voiture 5(H75.couleui 



pour joindre le depannage de la voiture rouge composes le 25314304 
pour joindre le depannage de la voiture verte composes le 2531430 
pour Joindre le depannage de la voiture bleue composer le 2531430 



t 



sdifie le tel de In votr.mc rouge 

desormais, pour joindre le depannage de la voiture rouge composer le 26629266 

desormais, pour joindre le depannage de la voiture verte composez le 26629266 

desormais, pour joindre le depannage de la voiture bleue composer le 26629266 



Figure 14-15 

Programme du document principal enregistre dans V image cle 1 de 1' animation maVoiture6.fla 



Si nous testons notre document Flash, les messages suivants doivent s'afficher dans le panneau 
Sortie (voir figure 14-15) : 

pour joindre le depanneur de la voiture rouge composez le 25314304 

pour joindre le depanneur de la voiture verte composez le 25314304 

pour joindre le depanneur de la voiture bleue composez le 25314304 
je modifie le tel de la voiture rouge 

desormais, pour joindre le depanneur de la voiture rouge composez le 26629266 

desormais, pour joindre le depanneur de la voiture verte composez le 26629266 

desormais, pour joindre le depanneur de la voiture bleue composez le 26629266 
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Creation d'une sous-classe 

Rappelons que lorsqu'une classe (que nous nommerons dans ce cas sous-classe) herite d'une autre 
classe (que nous nommerons dans ce cas « superclasse »), elle dispose des memes membres (proprie- 
tes et methodes) que la superclasse. Une sous-classe peut cependant se voir affecter des membres en 
complement de ses membres herites. 

L'heritage permet done de decliner une meme classe en de nombreuses sous-classes a partir de la 
declaration deja creee. II facilite aussi leur maintenance, car il est possible de repercuter automatiquement 
dans les differentes sous-classes toutes les modifications effectuees sur la superclasse. 
La syntaxe d'une sous-classe est identique a celle d'une classe traditionnelle, hormis le fait qu'il faut 
ajouter le mot-cle extends suivi du nom de la superclasse apres l'identifiant retenu pour designer la 
sous-classe (exemple : cl ass camionnette extends voiture). 



Application pratique 

Nous vous proposons de creer une sous-classe camionnette qui herite de toutes les proprietes et 
methodes de la classe voiture. En plus de cet heritage, la sous-classe sera dotee d'une propriete 
supplementaire concernant le volume de son chargement (vol ume_charge) calcule a l'aide de parametres 
passes en argument lors de son instanciation (haut^charge, 1 arg^charge, 1 ong_charge). 

Commencons par declarer la superclasse voiture dans un fichier voiture. as (nous reprendrons le 
meme script que la classe voiture utilisee dans les exemples precedents). Nous enregistrerons les 
trois fichiers dans le meme repertoire : FLASH- POOUestHeritage : 

// Declaration de la superclasse voiture 

class voiture 
{ 

// Declaration des proprietes utilisees 

var couleur:String; 
var vitesse:Number; 

// Declaration du constructeur 

function voiture(choix_couleur:String) 
{ 

vitesse=0; 

// Initialise la Vitesse a 0 
coul eur=choix_coul eur ; 

// La couleur est affectee selon le parametre 
} 

II Declaration des methodes communes a la classe "voiture" 

function accelererO 
{ 

vitesse++; 

// Incremente la vitesse si on accelere. 
} 

function freinerO 
{ 

vitesse-- ; 

// Decremente la vitesse si on freine 
} 

} // Fin de la superclasse voiture 
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Dans le meme repertoire (FLASH-POO\testHeritage), creons la sous-classe camionnette dans un 
fichier de classe cami onnette .as avec le code ci-dessous : 

class camionnette extends voiture 



// — Declaration des proprietes ajoutees (volume de chargement) 
var vol ume_charge: Number; 

// — Declaration du constructeur de la sous-classe camionnette 
function cami onnette (choix_couleur: St ring, ha ut_charge: Number, 
**1 a rg_charge: Number ,1 ong_charge: Number) 
{ 

vol ume_charge=haut_charge*l arg_charge*long_charge; 
// Initialise la dimension du volume de chargement 
this.coul eur=choix_coul eur ; 

// Initialise le parametre couleur declare dans la superclasse 
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// declaration des proprietes ajoutees (volume de chargement) 

var volume_charge:Number; 

// — declaration du constructeur de la sous classe camionnette 

function camionnette (choix_couleur : String, haut_charge: Number, larg_charge: Number 
( 

volume_charge"hout_charge*larg_charge*long_charge; 

//initialise la dimension du volume de chargement 
this.couleur-choix_couleur; 

//initialise le parametre couleur declare dans la superclasse 
> 
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Figure 14-16 

Script de la sous-classe enregistree dans le fichier exteme camionnette. as 
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Enfin, creons un nouveau document Flash afin de tester nos deux flchiers de classes (ce document 
devra etre enregistre dans le meme repertoire (FLASH-POO\testHeritage) que les deux flchiers de 
classes precedents) : 

var camionnette_89W75:camionnette =new camionnette("rouge",2,2,2); 
trace("Je viens d'acheter une superbe camionnette "+camionnette_89W75.couleur) ; 
trace("son volume de chargement est de "+camionnette_89W75.vol ume_charge+" metres cube"); 
trace("et, au debut, sa vitesse est de "+camionnette_89W75.vitesse+"km/h"); 
for (var i :Number=0;i<5;i++) 
{ 

tracet " j ' accel ere encore"); 
camionnette_89W75.accel erer( ) ; 
} 

traceC'sa vitesse est maintenant de"+camionnette_89W75.vitesse+" km/h"); 
for ($i=0;$i<5;$i++) 
{ 

traceC'je freine encore"); 
camionnette_89W75 .f reiner( ) ; 
} 

trace("sa vitesse est maintenant de "+camionnette_89W75.vitesse+"km/h") ; 
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Figure 14-17 
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Si nous testons le document, les messages ci-dessous doivent etre affiches dans le panneau Sortie. 
Nous constatons, d'une part, que la propriete complementaire correspondant au volume de charge- 
ment a bien ete calculee coiTectement (vol ume_charge est egal a8 = 2x2x2)et que, d'autre part, la 
sous-classe camionnette a bien herite des methodes accelererO et freinerO de la superclasse 
voiture (voir figure 14-17) : 

Je viens d'acheter une superbe camionnette rouge 
son volume de chargement est de 8 metres cube 
et, au debut, sa vitesse est de 0 km/h 
j ' accel ere encore 
j ' accel ere encore 
j ' accel ere encore 
j ' accel ere encore 
j ' accel ere encore 

sa vitesse est maintenant de 5 km/h 

je freine encore 

je freine encore 

je freine encore 

je freine encore 

je freine encore 

sa vitesse est maintenant de 0 km/h 
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Introduction 
aux bases de donnees 



Ce chapitre est une introduction aux bases de donnees et au systeme de gestion de base de donnees 
relationnelles (SGBDR) MySQL qui sera utilise dans la suite de cet ouvrage. Vous y decouvrirez les 
concepts fondamentaux ainsi que les mecanismes qui permettent d'acceder aux donnees stockees 
dans une base de donnees pour les integrer ensuite dans une page Web dynamique. Nous presente- 
rons egalement une methodologie de conception de base de donnees afin de vous guider dans l'etude 
et la conception de vos futurs projets. 

Concept d une base de donnees a partir de la metaphore 
du classeur 

Nous vous proposons de comparer le principe de la base de donnees avec la gestion des adherents 
d'un club de sport a l'aide de classeurs. Cet exemple sera repris pour vous expliquer la demarche a 
suivre pour creer une structure de base de donnees a partir d'un cas concret. 

Descriptif de la metaphore utilisee 

Imaginez un club de sport dans lequel la gestion des adherents est realisee a l'aide de classeurs 
(boites permettant le classement de Aches a onglet). Ces classeurs sont ranges dans une armoire. Le 
premier classeur porte l'etiquette adherents et comprend toutes les Aches des adherents. Afin de 
pouvoir acceder rapidement a sa fiche, le numero de membre (numero unique) de chaque adherent est 
indique sur 1' onglet. Outre ce numero, chaque fiche comporte des cases pre-imprimees qui permet- 
tent de saisir le nom de l'adherent, son prenom, l'annee de sa naissance et l'identifiant du cours 
auquel il est inscrit. 
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Un second classeur porte l'etiquette cours et regroupe les fiches de chaque cours correspondant aux 
differents niveaux des joueurs. De la meme maniere que pour la fiche des adherent, nous reporterons 
sur l'onglet de chaque fiche l'identifiant du cours (numero unique) et dans les cases pre-imprimees le 
niveau des joueurs (debutant, intermediaire ou perfectionnement), le jour et l'heure du cours ainsi 
que le numero du professeur qui anime le cours (voir figure 15-1). 

Un troisieme classeur porte l'etiquette prof esseurs et regroupe les fiches des professeurs qui animent 
les cours. Nous retrouverons sur l'onglet de chaque fiche le numero de carte de membre du personnel 
du club (numero unique) et dans les cases pre-imprimees de la fiche les nom, prenom et numero de 
telephone du professeur (voir figure 15-1). 



Figure 15-1 

Organisation du systeme 
de classeurs du club 
de sport 
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prenom : Jean-Marie 
naissance : 1960 



oursID \l \ - 
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inter-classeurs 



niveau Intermediaire 
jour : Vendredi 
horaire : 18 h 



professeursID | 2 | ~ 



Liaisons 
inter-classeurs 



nom : Dupond 
prenom : Alain 
Tel : 0145636800 
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Similitudes avec une base de donnees 

Maintenant que vous connaissez l'organisation du classement de ce club de sport, nous allons le 
comparer avec la structure d'une base de donnees afin de mettre en evidence certaines similitudes. 

La fonction du classeur est identique a celle que Ton attend d'une table de base de donnees : tous 
deux sont exploites comme les conteneurs des donnees du systeme. Les Aches contenues dans le 
classeur peuvent s'apparenter aux differents enregistrements qui viendront enrichir la table au gre 
de son utilisation. De meme, les cases pre-imprimees sur chaque fiche correspondent aux champs 
d'une table. La case de l'onglet (dans laquelle, par exemple, est inscrit le numero de membre pour le 
classeur des adherents) identifie chaque fiche d'une maniere unique et permet de sortir une fiche 
specifique du classeur sans ambiguite. La fonction de cet onglet est identique a celle de la cle 
primaire d'une table, qui sert de point d'entree unique permettant d'acceder a un enregistrement 
determine. Enfin, l'armoire regroupant les differents classeurs peut etre assimilee a la base de 
donnees, qui regroupe les differentes tables du systeme (voir figure 15-2). 



Figure 15-2 

Similitudes entre la metaphrase du classeur et la terminologie des bases de donnees 

Certaines similitudes sont interessantes a relever dans le domaine de la gestion du systeme de 
donnees, notamment en ce qui concerne la procedure a suivre pour inserer ou modifier une fiche. 
Lorsque vous ajoutez une nouvelle fiche dans le classeur, vous devez vous assurer que le numero de 
membre reporte sur l'onglet n'est pas deja attribue a un membre du club. Dans une base de donnees, 
il faut proceder de la meme maniere lors de l'ajout d'un nouvel enregistrement afin de preserver 
l'integrite de votre table (la cle primaire d'une table est obligatoirement unique). 



Enregistrements (fiches) 




/ Cle etrangere 1 

(identifiant de liaison inter-classeurs) 

Base de donnees (armoire contenant tous les classeurs) 
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Pour modifier ou supprimer une fiche, il faut la sortir du classeur en utilisant le numero de son onglet. 
Une fois la fiche extraite du classeur, vous pouvez la detruire ou modifier ses valeurs pour ensuite la 
reintegrer a sa place d'origine dans le classeur. De la meme maniere, dans une base de donnees, vous 
utiliserez la cle primaire pour supprimer ou modifier un enregistrement specifique. La cle primaire 
etant unique, elle permet d'acceder a un enregistrement sans aucune ambigui'te. 

Enfin, si Ton observe la fiche d'un adherent, on remarque que la derniere case, nominee cours ID, 
permet de connaitre Fidentifiant du cours (elle correspond a la cle primaire du classeur cours si Ton 
utilise la terminologie des bases de donnees) auquel il est inscrit. A l'aide de cette case, on peut 
extraire la fiche du cours correspondant si Ton desire avoir plus d' informations (niveau, jour et heure 
du cours, par exemple). Cette case correspond exactement au concept de la cle etrangere dans une 
base de donnees. La liaison entre une cle primaire et une cle etrangere permet de creer des liens entre 
des tables differentes. Grace a ce lien, il est possible d' extraire simultanement des donnees issues 
de deux tables differentes (cette operation est appelee « jointure » dans la terminologie des bases de 
donnees). 

Limites de la metaphore 

Comme la plupart des metaphores, la notre a ses limites. Nous allons preciser celles-ci afin que vous 
ne vous fourvoyiez pas dans de fausses similitudes. 

La metaphore utilisee ne peut pas etre exploitee pour expliquer le principe des requetes selectives 
d'enregistrements. En effet, avec le systeme des classeurs, la selection d'une fiche ne peut etre effec- 
tuee qu'a l'aide de la cle primaire et il est impossible de selectionner un ensemble de fiches selon des 
criteres s'appuyant sur des cles secondaires. Par exemple, il n'est pas possible de selectionner toutes 
les fiches des adherents ayant le meme age sans sortir toutes les fiches pour consulter la case corres- 
pondante (anneeNaissance). Cependant, il est important de comprendre ce concept, car ces requetes 
sont frequemment utilisees avec les bases de donnees relationnelles. 

D' autre part, le systeme de classeurs utilise dans la metaphore est deja fortement structure et ne fait 
pas apparaitre les problemes de redondance d' informations pourtant frequents. Pour ce faire, il 
faudrait imaginer un systeme plus simple ne comportant qu'un seul classeur avec des fiches plus etof- 
fees dans lesquelles seraient reportes le nom du professeur ainsi que le jour et l'heure de son cours. 
Dans ce cas, le changement d'horaire ou de responsable d'un cours entrainerait la modification de 
toutes les fiches concernees en raison de la redondance des donnees. Ces modifications seraient 
longues et laborieuses. En outre, il y aurait un risque d'incoherence si la modification d'une des 
fiches etait oubliee. Dans un systeme de base de donnees, cela n'est pas concevable et il est tres 
important de s'assurer (lors de la conception de la base) qu'une meme information n'est representee 
qu'une seule fois, en creant si besoin des tables differentes pour chaque entite (voir figure 15-1). 



Terminologie elementaire d'une base de donnees 

Terminologie structurelle de la base de donnees relationnelles 

Dans le monde des bases de donnees, il existe differents modeles de representation des donnees : 
modele hierarchique, modele reseau, modele objet, modele relationnel, etc. MySQL s'appuie sur le 
modele le plus frequemment employe, le modele relationnel. 
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Le modele relationnel permet de structurer les donnees d'une base en reliant les informations d'une 
table avec celles d'une autre table a l'aide de relations, d'ou son nom. L'avantage d'une base de 
donnees relationnelles est que Ton peut extraire des donnees de plusieurs tables a l'aide de ces relations 
arm de repondre rapidement a des requetes avancees. 

Sans entrer dans des explications avancees sur le fonctionnement d'une base de donnees, il est important 
de comprendre comment elle est structuree et de connaitre la terminologie employee. 

Une base de donnees est constitute d'enregistrements qui regroupent un ensemble d' informations 
(ou champs) liees et traitees comme une entite unique. L' ensemble des enregistrements partageant les 
memes champs s'appelle une table. Si on compare la table avec un tableau traditionnel, les colonnes 
du tableau sont les equivalents des champs de la table et ses lignes peuvent etre comparees aux enre- 
gistrements de la table. Enfin, une base de donnees peut contenir plusieurs tables, liees entre elles par 
des relations cle primaire-cle etrangere ou independantes (voir figure 15-3). 
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Figure 15-3 

Structure d'une base de donnees relationnelles 



Terminologie du systeme de gestion de base de donnees relationnelles 
MySQL 

L'utilisation d'une base de donnees necessite de passer par un gestionnaire, appele « SGBDR » dans 
le cas d'une base de donnees relationnelles telle que MySQL. Si Ton decompose l'acronyme 
SGBDR, S et G sont les initiales de systeme de gestion, B et D celles de base de donnees et le R indi- 
que que la base de donnees est de type relationnel. MySQL reposant sur une architecture client- 
serveur, le SGBDR se compose d'un programme serveur (mysqld) installe sur la machine sur 
laquelle sont stockees les donnees, qui repond aux requetes qui lui sont envoyees, et d'un programme 
client, qui permet de se connecter au serveur et d'emettre des requetes pour extraire ou manipuler les 
donnees de la base (voir figure 15-4). 
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A noter 

Sur la plupart des petits systemes, le client et le serveur sont installes sur la meme machine. Dans ce cas, le 
serveur MySQL peut etre identifie par localhost. 

MySQL prend en charge plusieurs clients mais il est livre par defaut avec le client mysql. 

Attention ! 

Ne confondez pas mysql (en general en minuscules), qui est le nom d'un programme client et MySQL (en general 
en majuscules), qui represente le serveur de base de donnees. 

Dans le cadre de cet ouvrage, nous ne presenterons pas le client mysql qui necessite de saisir des 
commandes en lignes de code pour gerer les donnees de la base. Nous utiliserons une interface 
graphique plus intuitive nommee phpMy Admin et constituee de formulaires PHP accessibles depuis 
un simple navigateur (voir chapitre 16 pour plus d' informations sur son utilisation). 



Base de donnees 
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Table : professeurs 
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(programme 
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phpMyAdmin 

(programme client 
developpe en PHP) 



serveur MySQL 



serveur Web (client) 




Administrateur 
de la base de 
donnees 



Figure 15-4 

Architecture client- serveur du SGBD MySQL 



Methodologie de conception d une base de donnees 

La conception d'une base de donnees est essentielle pour le developpement d'une application dyna- 
mique performante. En effet, la base de donnees est le cceur d'un systeme dynamique et une erreur 
dans sa conception peut entrainer des problemes importants et difncilement recuperables dans la 
suite du developpement du projet. 

Les methodes de conduite d'un projet dynamique mettent souvent en ceuvre des processus lourds et 
tres structures bases en general sur la methode Merise. Nous vous presentons une methodologie 
beaucoup plus simple et moins formelle (que les puristes nous pardonnent !) dont le modeste objectif 
est de vous initier aux regies de la conception d'une base de donnees afin que vous puissiez rapidement 
creer de petits sites dynamiques bien structures. 
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Definition des besoins 

Methodologie de definition des besoins 

Pour concevoir une base de donnees, il faut commencer par bien definir les besoins des utilisateurs 
auxquels elle doit repondre. Pour ce faire, il convient de delimiter le systeme, de realiser l'inventaire 
des elements necessaires a son fonctionnement et d' identifier les contraintes a respecter. 

Si nous reprenons l'exemple du club de sport utilise plus haut, F expression des besoins correspon- 
dant a la creation d'un systeme de base de donnees destine a remplacer la gestion du club de sport a 
l'aide de classeurs pourrait etre formalisee comme indique ci-dessous. 

Expression des besoins du projet Sport 

Le projet Sport doit permettre de gerer les coordonnees des adherents et des professeurs dispensant 
les cours ainsi que les horaires et niveaux des differents cours du club. 

Chaque adherent sera identifie par son numero de membre (numero unique). Ses nom et prenom, sa 
date de naissance et le cours auquel il est inscrit seront indiques. 

Chaque cours sera identifie par un numero specifique (numero unique). Le niveau des joueurs, le jour 
et l'heure du cours ainsi que le professeur qui l'anime seront indiques. 

Chaque professeur sera identifie par le numero de sa carte de membre du personnel du club (numero 
unique). Ses nom, prenom et numero de telephone seront indiques. 

Enfin, il faut fixer certaines contraintes concernant les relations entre les entites du systeme afin 
d'eviter que la structure de la base ne soit inutilement complexe. Ainsi, dans notre exemple, un adhe- 
rent ne peut etre inscrit que dans un seul cours et un cours ne peut etre anime que par un seul professeur 
(en revanche, un meme professeur peut evidemment animer plusieurs cours). 

Le systeme final doit pouvoir extraire de la base de donnees une liste des adherents precisant pour 
chacun le cours auquel il assiste (niveau, horaire et jour) ainsi que le nom et le numero de telephone 
du professeur qui anime celui-ci. 



Elaboration d'un modele entite-association 
Methodologie de conception d'un modele E/A 

Pour elaborer une base de donnees, on cree souvent une premiere description conceptuelle materia- 
lisee par un modele entite-association (E/A). C'est une representation graphique des entites qui consti- 
tuent la base de donnees et des associations (ou relations) pouvant exister entre ces entites. On obtient 
ainsi une premiere representation conceptuelle de la base de donnees a l'aide d'un modele graphique, 
ce qui facilite sa comprehension. 

Pour elaborer un modele E/A, il faut identifier les elements et caracteristiques suivants : 

• L'entite : une entite est la representation d'un element materiel ou immateriel identifie par le concepteur 
comme ayant un role dans le fonctionnement du systeme a realiser (F adherent ou le cours par exemple). 

• Les attributs : les entites d'un projet sont caracterisees par des attributs (nom, prenom, etc.). 
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• L'identiflant : 



l'identifiant est l'attribut qui permet d'identifier d'une maniere unique une entite. 



A noter 

Dans de nombreux cas, il est difficile de trouver un identifiant dans les attributs de I'entite. Dans ce cas, on cree un 
identifiant « abstrait » materialise par un attribut supplemental auquel on affectera un numero sequentiel 
(numero increments a chaque ajout d'un enregistrement). 



• L' association : si des entites sont lies par une relation (par exemple I'entite adherents est lie a I'entite 
cours par la relation « est dans le cours »), il faut alors faire apparaitre l'association entre les deux 
entites. 

• La cardinality : chaque extremite d'une association entre deux entites doit etre caracterisee par sa 
cardinalite. Theoriquement, la cardinalite est composee de deux valeurs specifiant le nombre 
minimal et le nombre maximal d' occurrences pouvant lier l'attribut concerne avec 1' autre attribut 
de l'association (par exemple si Ton considere qu'un professeur doit animer un cours au minimum 
et sans limite maximum, sa cardinalite serait 1 , n). Pour simplifier notre methode, nous ne conside- 
rerons que la valeur maximale de la cardinalite (done la cardinalite du professeur sera egale a n 
dans F exemple precedent). 

• Type d'association : si la cardinalite d'une extremite de l'association est 1 (une occurrence au 
maximum) et que celle de l'autre extremite est n (pas de limite du nombre d' occurrences), l'asso- 
ciation concernee sera de type 1 - n. 

Une fois les entites et associations identifiees, on peut dessiner le modele E/A. Une entite sera repre- 
sentee par un rectangle. On indiquera son nom dans sa tete et la liste de ses attributs dans son corps. 
II faut definir une convention pour representer l'identifiant dans la liste des attributs. Dans notre 
exemple, nous soulignerons son nom. 

Les associations entre les entites seront representees par un trait les reliant. A chaque extremite, 
seront indiquees les cardinalites qui les caracterisent. 



Figure 15-5 
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Modele E/A du projet Sport 

Nous allons creer le modele E/A du projet Sport (voir figure 15-6). Si on analyse l'expression des besoins 
du projet (voir ci-dessus), on en deduit que le systeme comporte trois entites que nous nommerons 
adherents, cours et professeurs. De meme, nous pouvons identifier deux associations que nous 
nommerons « est dans le cours » (relation entre l'entite adherents et l'entite cours, de type 1 - n car 
un adherent ne peut etre inscrit que dans un seul cours et un cours n'est pas limite en nombre d' adhe- 
rents) et « est anime par » (entre l'entite cours et l'entite professeurs, de type 1 - n car un cours ne 
peut etre anime que par un seul professeur et un professeur peut animer de multiples cours). 



A noter 

Pour identifier les identites et leurs associations dans un projet, il est souvent interessant d'appuyer son raison- 
nement sur un cas particulier du systeme. 



"est dans le cours" "est anime par le professeur" 
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Figure 15-6 

Modele entite-ussociation du projet Sport 



Schema relationnel de la base de donnees 

Avec le modele E/A, nous disposons desormais d'une representation conceptuelle de la base de 
donnees. II nous faut maintenant batir une representation structurelle de cette base en integrant les 
differentes entites et leurs associations dans un schema relationnel directement exploitable. 

Methodologie de transcription d'un modele E/A en schema relationnel de base 
de donnees 

Pour transformer le modele E/A en un schema relationnel constitue des differentes tables de la base, 
nous commencerons par transformer les entites en tables. Les noms des champs seront les noms des 
attributs du modele E/A et la cle primaire sera l'identifiant de l'entite. 



A noter 

Nous conserverons la meme convention que celle utilisee pour l'identifiant d'une entite (nom du champ souligne) 
pour identifier la cle primaire de chaque table. 
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Ensuite, il faudra transcrire les liens des associations dans la nouvelle structure en appliquant une 
procedure differente selon le type de cardinalite de l'association (voir figure 15-7) : 

• Les associations 1 - n (cardinalite unique d'un cote et multiple de F autre) seront materialisees par la 
copie de la cle primaire de la seconde table dans un nouveau champ nomme cle etrangere dans F autre 
table. Pour identifier ce nouveau champ, il faut le nommer en rappelant le nom de la table initiale. 
Dans notre exemple, nous realiserons une concatenation du nom de la table et de sa cle primaire 
pour creer Fidentifiant de la cle etrangere correspondante. Par exemple, coursID est le nom de la 
cle etrangere placee dans la table adherents et qui correspond a la cle primaire ID de la table cours. 



A noter 

Ce type d'association est celui que Ton retrouve le plus frequemment dans les structures de base de donnees. 



• Les associations 1-1 (cardinalite unique des deux cotes) seront materialisees de la meme maniere 
que les associations 1 - n. 



A noter 

Ce type d'association est rare car il est souvent plus judicieux de regrouper les champs de la seconde table dans 
la premiere. Cela evite de creer une association supplementaire. 



• Les associations n - n (cardinalite multiple des deux cotes) seront materialisees par la creation 
d'une table supplementaire que nous nommerons table de jointure. Le but de celle-ci est de scinder 
l'association n - n en deux associations 1 - n. Pour ce faire, la table de jointure devra contenir la 
copie des cles primaires des deux autres tables. 
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Figure 15-7 

Selon lew type, les associations du modele E/A doivent etre transcrites de differentes fagons dans le schema 
relationnel de la base de donnees. 



A noter 

Ce type d'association est le plus complique a mettre en ceuvre. Definissez bien les contraintes de I'expression des 
besoins lors de I'analyse, afin d'eviter de creer des tables de jointure injustices. 
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Schema relationnel de la base de donnees Sport 

Nous pouvons representer rapidement les trois tables adherents, cours et professseurs en leur affectant 
comme champs les noms des attributs correspondants. 

La transcription des associations est, elle aussi, relativement simple a mettre en ceuvre car il s'agit de 
deux associations de type 1 -n. II suffit d'ajouter une premiere cle etrangere coursID dans la table 
adherents pour materialiser Fassociation « est dans le cours » (entre les entites adherents et cours) et 
une seconde cle etrangere professeursID dans la table cours pour materialiser Fassociation «est 
anime par » (entre les entites cours et professeurs). 

Le descriptif de la base que Fon obtient detaille la composition des trois tables (voir ci-dessous). II 
permettra de concevoir le schema relationnel de la figure 15-8. 

• Table adherents - regroupe les champs identifiant chaque adherent (champs : ID, nom, prenom, 
anneeNai ssance, coursID). 

• Table cours - regroupe les champs identifiant chaque cours (champs : ID, niveau, jour, horaire, 
professeursID). 

• Table professeurs - regroupe les champs caracterisant chaque professeur (champs : ID, nomProf, 
prenomProf, tel). 



TABLE : adherj 



coursID 



Cles primaires 




TABLE : cours 



professeursID 



■ Cles etrangeres 



t 



Figure 15-8 

Schema relationnel de la base de donnees Sport 



TABLE : professeurs 



ID 

nomProf 

prenomProf 

tel 



La prochaine etape consiste a creer la base de donnees a Faide de ce schema relationnel en tenant 
compte des specificites de MySQL. Cette partie est traitee dans le chapitre 16 avec F etude du 
gestionnaire phpMy Admin. 
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Gestion d'une base de donnees 

avec phpMy Admin 



PhpMyAdmin, un gestionnaire de bases convivial 

PhpMy Admin est une interface conviviale qui permet de gerer tres facilement une base de donnees et 
ne necessite pas une connaissance avancee des requetes SQL. Elle est developpee en PHP, ce qui la 
rend parfaitement adaptee lors de l'utilisation conjointe d'une base MySQL et d'un moteur de scripts 
PHP. Elle fonctionne directement sur le serveur Web et est accessible par le biais d'un simple navi- 
gateur, ce qui explique sa presence sur la plupart des sites dynamiques distants (actuellement, 
phpMyAdmin est le gestionnaire de bases de donnees preconise par la majorite des hebergeurs 
proposant des serveurs qui prennent en charge MySQL/PHP). On peut ainsi creer avec la meme faci- 
lite des bases de donnees et des tables en local comme sur le serveur distant. 

Avec le gestionnaire de bases de donnees phpMyAdmin, vous pourrez rapidement : 

• creer et supprimer des bases de donnees ; 

• creer, copier, supprimer et modifier des tables ; 

• supprimer, editer et aj outer des champs ; 

• executer des requetes SQL ; 

• importer et exporter des donnees au format CSV ; 

• creer et exploiter des sauvegardes de tables. 
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Presentation de I'interface de phpMyAdmin 

Comme nous Favons explique dans le chapitre consacre a F infrastructure serveur, la suite logicielle 
Wamp 5 integre le gestionnaire phpMyAdmin. Pour acceder a l'ecran du gestionnaire, commencez 
par vous assurer que Wamp 5 est bien actif (l'icone de Wamp doit etre presente dans la zone d'etat), 
puis cliquez sur son icone. Selectionnez ensuite phpMyAdmin dans le menu contextuel. Le gestion- 
naire s'ouvre alors dans le navigateur. L'ecran d'accueil (voir figure 16-1) est partage en deux parties. 
A gauche, une liste deroulante permet de selectionner la base de donnees desiree. La partie droite est 
utilisee pour creer une nouvelle base. En bas de l'ecran, un message en rouge vous rappelle que 
l'utilisateur principal (le root) est actuellement configure sans mot de passe, ce qui represente une 
faille de securite si ce serveur devait etre accessible depuis l'exterieur. Nous detaillerons plus loin la 
procedure pour gerer les droits des utilisateurs. Pour l'instant, ne modifiez pas le parametrage du root 
car nous nous limiterons a un usage local de la base de donnees. 



3 locdlhost / localhost | phpMyAdmin 7.7. 0-pM - Microsoft Internet Explorer 
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Figure 16-1 

L'ecran d'accueil du gestionnaire de bases de donnees phpMyAdmin propose de creer une nouvelle base en 
indiquant son nom dans le champ central ou de la selectionner dans la liste deroulante de gauche si elle existe 
dejd. 



Si on observe les choix proposes dans la liste des bases (menu deroulant de gauche), on decouvre 
quatre bases par defaut : 

information_schema : e'est une base de donnees qui stocke toutes les informations a propos des 
autres bases que le serveur MySQL entretient. Dans cette base, plusieurs tables sont en lecture seule. 
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mysql : la base mysql est tres importante, car elle contient toutes les tables qui permettent de configu- 
rer et de gerer les differents droits des utilisateurs pour l'accession aux autres bases de donnees du 
serveur (nous verrons a la fin de ce chapitre comment creer et configurer un compte utilisateur pour 
pouvoir avoir acces a la base MySQL depuis vos scripts dynamiques). II ne faut done jamais supprimer 
cette base sous peine de ne plus pouvoir utiliser le serveur MySQL. 

phpmyadmin : la base de donnees phpmyadmin (a ne pas confondre avec le gestionnaire lui-meme : 
phpMyAdmi n) permet, entre autres, de creer des documents PDF a partir des tables MySQL, ou encore 
de gerer l'authentification de multiples utilisateurs par cookies . . . 

test : La base test est une base secondaire sans table destinee uniquement a realiser des essais de 
connexion. 

Rassurez-vous, dans le cadre de cet ouvrage, vous n'aurez pas a gerer ces differentes bases. En revan- 
che, nous utiliserons souvent ce menu pour acceder a la base de donnees uti 1 i sateur que nous allons 
creer dans la partie suivante (sport_db) 



Soyez prudent dans la modification des donnee... 

Hormis la base de donnees test, les trois autres bases installees par defaut sont tres importantes dans le fonction- 
nement du serveur de base de donnees. Aussi, nous vous conseillons d'etre tres prudent si vous desirez modifier le 
contenu d'une de ces trois bases car une mauvaise manipulation risque de rendre votre serveur MySQL inoperant. 



Creation et gestion d'une base de donnees 

Pour vous initier a F utilisation de phpMyAdmin, vous allez creer une petite base de donnees en 
reprenant l'exemple de l'application SPORT presentee precedemment pour illustrer les concepts de la 
base de donnees. Cette premiere base est tres simple et comporte seulement trois tables. 

Definition du type de chaque champ 

II faut prealablement choisir le type de chaque champ pour chaque table. Pour ce faire, nous avons 
utilise la table adherents et nous avons detaille la nature et la taille des sept champs qu'elle contient 
(il convient d'en faire autant avec les autres tables avant de determiner le type de chaque champ) : 

• ID - identifiant de l'enregistrement (cle primaire) : nombre entier positif ; 

• professeursID - identifiant du commercial (correspond a la cle primaire de la table professeurs) : 
nombre entier positif ; 

• nom - nom de l'adherent : texte de 200 caracteres au maximum ; 

• prenom - prenom de l'adherent : texte de 200 caracteres au maximum ; 

• anneeNai ssance - annee de naissance de l'adherent : 4 chiffres au format de F annee. 

Dans la terminologie des bases de donnees, on distingue trois grandes families de types de champs : 

• type numerique (entier ou decimal) ; 

• type texte (chaine de caracteres) ; 

• type annee, date et heure. 
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Pour chacune de ces families, il existe un nombre important de types de donnees. Le choix du type de 
donnees au sein d'une meme famille est important pour l'optimisation de la base car il determine le 
meilleur compromis entre la limite du nombre de valeurs exploitables et Fespace memoire utilise. 
Pour notre premiere base, nous nous limiterons a l'utilisation des principaux types, qui sont resumes 
dans les tableaux ci-dessous. 



Tableau 16-1. Principaux types de champs numeriques 



Type 


Options* (en maigre)et 
parametres* 
obligatoires (en gras) 


Taille memoire 
(en octets) 


Description 


TINYINT 


(M) 

UNSIGNED 


l 


Entier entre 0 et 255 en non signe (UNSIGNED) et - 128 
et + 127 en signe (sans option) 


SMALLINT 


(M) 

UNSIGNED 


2 


Entier entre 0 et 65 535 en non signe (UNSIGNED) et 
- 32 768 et + 32 767 en signe (sans option) 


INT 


(M) 

UNSIGNED 


4 


Entier entre 0 et 16 777 215 en non signe (UNSIGNED) et 
- 8 388 608 et + 8 388 607 en signe (sans option) 


DECIMAL 


(M.D) 


M 


Nombre signe enregistre sous forme d'une chaine de 
caracteres 


(*) Definition des options et des parametres obligatoires : 

(M) : indique le nombre maximal de chiffres, avec une limite a 255. 

( M . D ) : indique le nombre maximal de caracteres et le nombre de decimales affichees. 

UNSIGNED : indique qu'il s'agit d'un nombre positif. Dans ce cas, il n'y a pas de bit de signe et la valeur positive maximale est 
plus importante. 


Tableau 16-2. Principaux types de champs de texte 


Type 


Options* (en maigre)et 
parametres* 
obligatoires (en gras) 


Taille memoire 
(en octets) 


Description 


CHAR 


(M) 

BINARY 


M < 256 


Chaine de caracteres d'une longueur fixe de M caracteres 


VARCHAR 


(M) 

BINARY 


L + 1 


Chaine de caracteres d'une longueur variable limitee 
a M caracteres. La longueur reelle de la chaine est L 
(L < 256) 


TEXT 




L + 2 


Texte de 1 a 65 535 caracteres. La longueur reelle du texte 
estL(L<65 536) 


ENUM 


'valeurl' . 'valeur2'... 




Enumeration de valeurs avec un maximum de 
65 535 valeurs differentes. 


(*) Definition des options et des parametres obligatoires : 



(M) : indique le nombre maximal de chiffres, avec une limite a 255. 

BINARY : indique que la chaine de caracteres sera sensible a la casse dans les operations de comparaison et de tri (option a 
utiliser avec precaution). 
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Tableau 16-3. Principaux types de champs dates et heures 



Type 


Options* (en maigre)et Taille memoire Description 
parametres* (en octets) 
obligatoires (en gras) 


DATETIME 


8 


Date au format AAAA-MM-JJ HH:MM:SS 

de 1000-01-01 00:00:00 a 9999-12-31 23:59:59 


TIME 


3 


Heure au format HH:MM:SS 
de - 838:59:59 a 838:59:59 


DATE 


3 


Date au format AAAA-MM-JJ 
de 1000-01-01 a 9999-1 2-31 


YEAR 


1 


Annee au format AAAA 
de 1901 a 21 55 


A partir de ces informations, il faut attribuer a chaque champ des trois tables de la base le type de 
donnee qui lui correspond le mieux selon les exigences formulees dans le cahier des charges. 

Les trois tableaux ci-dessous indiquent les choix retenus pour l'application SPORT. 




Tableau 16-4. Types des champs de la table adherents 


Norn du champ Type Taille/Valeurs 


Description 


ID 


TINYINT 


Tres petit entier (maximum 255 en UNSIGNED) 
Identifiant : cle primaire de la table 


coursID 


TINYINT 


Tres petit entier (maximum 255 en UNSIGNED) 


nom 


VARCHAR 200 


Chaine de 200 caracteres au maximum 


prenom 


VARCHAR 200 


Chalne de 200 caracteres au maximum 



YEAR 



Format annee 



Tableau 16-5. Types des champs de la table cours 



Nom du champ 


Type 


Taille/Valeurs 


Description 


ID 


TINYINT 




Tres petit entier (maximum 255 en UNSIGNED) 
Identifiant : cle primaire de la table 


professeursID 


TINYINT 




Tres petit entier (maximum 255 en UNSIGNED) 


niveau 


VARCHAR 


20 


Chaine de 20 caracteres au maximum 


jour 


VARCHAR 


20 


Chaine de 20 caracteres au maximum 


horai re 


TINYINT 




Tres petit entier (maximum 255 en UNSIGNED) 




Tableau 1 6-6. Types des 


champs de la table professeurs 


Nom du champ 


Type 


Taille/Valeurs 


Description 


ID 


TINYINT 




Tres petit entier (maximum 255 en UNSIGNED) 
Identifiant : cle primaire de la table 


nomProf 


VARCHAR 


200 


Chaine de 200 caracteres au maximum 


prenomProf 


VARCHAR 


200 


Chaine de 200 caracteres au maximum 


tel 


VARCHAR 


20 


Chaine de 20 caracteres au maximum 
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Creation de la base de donnees 

Une fois les types de champs choisis, vous pouvez creer la base dans phpMy Admin. Dans la zone du 
centre, saisissez le nom de la nouvelle base, sport_db, puis cliquez sur le bouton Creer (voir 
figure 16-1). Le nom de la nouvelle base s'affiche dans le cadre de gauche avec la mention « Aucune 
table n'a ete trouvee dans cette base ». 



Creation d'une table 

Dans le cadre de droite, saisissez le nom de la table a creer (adherents par exemple, pour la premiere 
table de la base sport_db), renseignez le nombre de champs (cinq pour notre exemple) puis cliquez 
sur le bouton Executer (voir figure 16-2). L'ecran suivant est un formulaire destine a renseigner les 
noms, types et parametres des champs a creer (voir figure 16-3). Pour chaque champ a definir, repor- 
tez dans les colonnes Champs, Type et Taille/Valeurs de ce formulaire les informations definies 
precedemment (voir le tableau 16-4 pour notre exemple). Considerons que tous les champs sont 
indispensables et conservons Foption not null pour les informations de la colonne null de chaque 
champ. II faut ensuite indiquer que le champ ID fait office de cle primaire et cocher la case primaire 
a l'extreme droite du formulaire. D'autre part, afin que les donnees de ce champ soient toujours diffe- 
rentes (une cle primaire doit toujours etre unique), selectionnez Foption auto_increment dans la liste 
deroulante de la colonne extra (le compteur est automatiquement incremente a chaque ajout d'un 
nouvel enregistrement). Maintenant, il ne vous reste plus qu'a cliquer sur le bouton Sauvegarder pour 
creer cette nouvelle table. 



3 localhost / localhost /sport_dl> | phpMyAdmin 2.7.0-pl1 Microsoft Internet Explorer 
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Figure 16-2 

Pour creer une nouvelle table, ilfaut commencer par indiquer son nom et le nombre de champs qu 'elle contient. 
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Figure 16-3 

Toutes les informations relatives a la nouvelle table doivent etre renseignees dans ce formulaire. 



Si vous n'avez pas fait d'erreur, un nouvel ecran indique la requete SQL produite automatiquement 
par phpMy Admin, ainsi qu'un tableau recapitulatif des proprietes de la nouvelle table (voir figure 16-4). 
Le nom de la table qui vient d'etre creee apparait desormais dans la partie gauche de Finterface. Les 
noms affiches dans la partie gauche permettent d'acceder rapidement a la structure de la table (onglet 
Structure). Vous pouvez ensuite afficher les autres rubriques concernant la table en cliquant sur 
l'onglet en rapport (Afficher, Structure, SQL, Rechercher, Inserer, Exporter, Importer, Operation, 
Vider, Supprimer). 

Afin que la structure de la base de donnees sport_db soit complete, il faut renouveler cette procedure 
pour creer les deux autres tables (en utilisant les informations des tableaux 16-5 et 16-6). Pour cela, 
revenez a l'ecran correspondant a la premiere etape de la procedure de creation d'une table en 
cliquant sur le nom de la base sport_db dans le haut de l'ecran. En bas du cadre de droite, vous 
retrouvez les deux champs de creation d'une nouvelle table. Indiquez cours pour le nom de la table et 
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Figure 16-4 

Apres validation, 
un tableau 
recapitulatif des 
proprietes de la 
nouvelle table 
creee s 'affiche a 
I 'ecran. 



3 local hint / locnlhotl / iport ilti / adhercn 


i I phpMyAdmtn J .' n pll Microsoft Interne! ftplorer 


Earns] 


Fr hat fdUen HU.h+X F«l« '>'»■. I 






QfteoMMe • Q ^ ^ /Jj 




v Hoc % 




I Modrfiar 1 1 Cr*« uource PHP | 







Cham 




Intatcl-WMiiianr Alt ill. lit* Null 


Defaul EwWe 










a 


B 




Han 


autojnt foment HI 


✓ 


X 






□ 


COMIlID 


l\>nl(4) 


Hon 


■ 


✓ 


x 


t a 




□ 


n«m 


«rlh»rC00) 


latin! _cw*di*h_ci Hon 


m 


✓ 


x 


ffi H 




□ 


pienem 




latin1_sw«Jish_ci Hon 




✓ 


X 




□ 


.inn f-H. it* 




Hon 


■ 


✓ 


X 


IS H 



»<ul d*cocha* Povt h »#lf<fw ■ y X IB IS IS 



Vttsion impnmabla <2 G*Hm da* r*4at*ro Ji Su9g*i»r da* optimisalion* quant a la tliuclu** da la labia IP 
H*#Oulw I Clwmp(i)©Enlindaiab*a OGn dabut da labia Q*»aa»|P J| ErtWNjTT 



5 pour le nombre de champs. Vous procederez de la meme maniere avec la table professeurs, qui ne 
contient que quatre champs (voir les formulaires de creation de ces deux tables, figures 16-5 et 16-6). 
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Insertion d'enregistrements 

Afin d'ajouter quelques enregistrements dans les nouvelles tables, nous allons utiliser la fonction 
Inserer de phpMy Admin. Pour illustrer la procedure, nous detaillerons les etapes pour la table adhe- 
rents. Vous pourrez ensuite suivre la meme methode pour remplir la table cours puis la table 
professeurs. 

Cliquez sur le nom de la base (sport_db) en haut de l'ecran. Dans la partie droite, vous devez obtenir 
un tableau recapitulatif des tables presentes dans la base (voir figure 16-7). Sur la meme ligne que la 
table concernee, plusieurs actions sont proposees. Elles sont reperees par differentes icones et par une 
infobulle qui s'affiche si vous laissez le curseur de votre souris immobile dessus. Par la suite, nous 
identifierons toujours une action par le libelle de Finfobulle correspondante afin d'eviter toute 
confusion : 

• Afficher - pour afficher tout le contenu de la table et done ses differents enregistrements (pas 
encore actif car la table est vide) ; 

• Structures - affiche les proprietes de la base dans un tableau. A utiliser si vous desirez modifier la 
structure de la table (ajouter ou supprimer des champs. . .) ; 

• Rechercher - pour afficher une selection de champs selon certains criteres (pas encore actif car la 
table est vide) ; 

• Inserer - pour inserer un nouvel enregistrement dans la base ; 
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• Vider - pour supprimer le contenu de la table (et done tous les enregistrements qu'elle contient) en 
conservant sa structure. 

• Supprimer - pour supprimer completement la table et son contenu. 
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Figure 16-7 

Pour chaque table de la base, vous pouvez rapidement realiser des actions : cliquez simplement sur le lien en 
rapport avec V action se trouvant sur la meme ligne que le nom de la table. 



Nous desirons ajouter un enregistrement a la table cours (pour les valeurs a saisir dans les champs, 
nous vous suggerons de prendre le premier enregistrement indique dans le tableau 16-7 ci-apres). 
Cliquez sur le lien Inserer sur la meme ligne que le nom de la table (voir figure 16-7). Un double 
formulaire de saisie pour chaque champ s'affiche alors dans le cadre de droite (voir figure 16-8). Ne 
saisissez pas de valeur dans le premier champ ID puisqu'il est incremente automatiquement. Saisis- 
sez les valeurs dans les autres champs comme indique sur la figure 16-8 (nous vous conseillons de 
saisir les valeurs indiquees si vous voulez obtenir des resultats identiques a ceux des visuels de cet 
ouvrage). Renouvelez les memes operations pour le second enregistrement puis cliquez sur Executer 
pour enregistrer vos donnees. 

Apres l'enregistrement, un message indique le nombre d' enregistrements inseres et rappelle la 
requete SQL produite automatiquement par phpMyAdmin pour effectuer cette action (voir 
figure 16-9). Vous pouvez aussi observer sur ce meme ecran que le nombre d'enregistrements indi- 
que en rapport avec la table adherents est 2 et que les liens Afficher et Rechercher sont desormais 
actifs. 
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Figure 16-8 

Le formulaire d'insertion de phpMyAdmin permet d'ajouter directement des enregistrements dans la table. 
Le champ de la cle primaire ID etant auto-incremente, il n 'est pas necessaire de saisir une valeur dans sa cellule. 
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Figure 16-9 

Des que la table contient au moins un enregistrement, tous les liens des actions sur la table deviennent actifs. 
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Attention a la gestion des apostrophes 

Lors de I'insertion dans la base de donnees MySQL d'un texte issu d'un formulaire ou d'un cookie, il faut theorique- 
ment prefixer chaque apostrophe de ce texte par « \ ». Cette action peut etre geree pour chaque enregistrement 
a I'aide des fonctions addSlashes( ) et stripSlashes( ). Une autre solution consiste a parametrer le fichier 
php.ini afin que celasoit automatique. II faut alors que I'option magic_quote_gpc du fichier php.ini soit initia- 
lisee avec la valeur On. Cependant, les dernieres versions de PHP sont configurees avec cette option initialisee a 
Off, ce qui vous oblige a utiliser systematiquement les fonctions addSl ashes ( ) et stri pSl ashes (). Nous vous 
invitons done a verifier la configuration de votre fichier php.ini et a la modifier eventuellement. 



Afin de pouvoir manipuler plusieurs enregistrements, nous vous suggerons de saisir dans les tables 
adherents, cours et professeurs les valeurs des tableaux 16-7, 16-8 et 16-9, en suivant la meme 
demarche que ci-dessus. Au terme de ces enregistrements, vous devez obtenir un ecran semblable a 
celui de la figure 16-10 et totaliser onze enregistrements, toutes tables confondues. Si vous cliquez 
par exemple sur Faction Afficher (voir repere sur figure 16-10) pour voir le contenu de la table adherents, 
la liste des adherents doit s'afficher (voir figure 16-11). 
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ML 


3 


Hamond 
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1983 


Tableau 16-8. Exemples d'enregistrements a saisir dans la table cours 


ID 
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Tableau 16-9. Exemples d'enregistrements a saisir dans la table professeurs 


ID 
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Figure 16-11 

L 'action Afficher permet de prendre connaissance du contenu des enregistrements de chaque table, d 'afficher 
le contenu d'une table et de modifier ou supprimer I'un de ses enregistrements. 



3 localhost / localhost / sport db j phpMyAdmin 2.7.0-pM - Microsoft Internet Exploi 



Etcher EdrtKW Afftchage Favoris QuUs I 

Qprtcedrrte • © ' Si SI <& I 



Ad/esse [ghtti>:/«oca»><>s«phr»nya*i»n/ 



v Q« 



Base de donnees 

I tpoft^db (3) 



■ adherents 

■ cours 

EE professeurs 



£9 Servem: localhost ► £S) Base de donnees: sport_db 
ggSiiucture JJEsQL > Recherche r g&R«quete &iExpoitei &Umponei S^Ope rations gAPitvlletjes 



y Sii|ipilinci 





Table 




Action 






Enreglstrenreirts 


Type 


Interclassernent 


Tallle 


Perte 


□ 


adherents I 




B h 


i 


>< 




VinoDB 


Iatrn1_swedish_ci 


160 Ko 




□ 


court 


a! eS 


a h 


i 


X 


'a 


jlnoDB 


Iatin1_swedish_ct 


160X0 




□ 


professeurs 


HI cS 


n h 


V 


X 




^nnoDB 


Iatin1_swedish_ci 


160 Ko 






3 tablets) 




Somme 






ii 


InnoDB 


Iatln1_swedish_cl 


46,0 Ko 


0 Octets 



Tout cocher/Tout decocher 



Pour la selection 



■> Version imprimable JB Dictionnaire de donnees 
- J) Cieei une nonvelle table sur la base sport_db- 



Nombre de champs 



| Executer" 



*J Intranet local 



Figure 16-10 

Apres avoir enregistre toutes les valeurs des tableaux 16-8, 16-9 et 16-10, les trois tables adherents, cours 
et professeurs doivent afficher un total de six, trois et deux enregistrements. 
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Modification d'un enregistrement 

En cas d'erreur de saisie ou simplement pour mettre a jour les informations, il est possible de modi- 
fier un enregistrement de la base. Pour cela, cliquez sur le lien Afficher de la table cours par exemple 
(meme icone que sur la figure 16-10 mais sur la ligne de la table cours). Un ecran affichant les diffe- 
rents enregistrements de la table apparait (voir figure 16-12). Deux actions sont alors disponibles 
pour chaque enregistrement : 

• Modifier - permet d' afficher de nouveau un formulaire de saisie et de modifier le contenu d'un 
enregistrement ; 

• Effacer - efface completement F enregistrement concerne de la table. 

Cliquez sur le lien Modifier en face du cours Intermediate (revoir figure 16-12). Dans l'ecran qui 
s'affiche (voir figure 16-13), vous devez retrouver le meme masque de saisie que pour un enregistre- 
ment initial, hormis le fait que les valeurs des champs sont deja initialisees. Au passage, remarquez 
que le champ ID de la cle primaire a ete initialise automatiquement a 2 lors de 1' enregistrement prece- 
dent grace a sa propriete d' auto-incrementation. II ne vous reste plus qu'a modifier la valeur erronee 
puis a valider en cliquant sur le bouton Executer (voir figure 16-13). Saisissez une nouvelle valeur 
dans le champ jour (samedi au lieu de vendredi). Le tableau d'affichage du contenu de la table doit 
maintenant tenir compte de cette modification (voir figure 16-14). 
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Figure 16-12 

Dans l'ecran affichant les differentes informations de la table cours, cliquez sur le lien Modifier en face 
de V enregistrement a actualiser. 
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Figure 16-13 

Z)a/?.s' /a procedure de modification d'un enregistrement, nous retrouvons le meme formulaire que celui utilise lors 
de Vinsertion d'un enregistrement. Pour modifier une donnee, il suffit de remplacer I'information dans le champ 
correspondant puis de valider en cliquant sur le bouton Executer. 
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Figure 16-14 

Apres la modification d'une valeur dans un enregistrement, celle-ci apparait dans le tableau d'affichage 
des enregistrements de la table. 
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Modification des proprietes d'une tabie 

Pour modifier les proprietes d'une table (ajout ou suppression d'un champ, par exemple), revenez sur 
l'ecran d'affichage des tables en cliquant sur le nom de la base, sport_db, dans le haut de l'ecran (voir 
repere 1 figure 16-15). Parmi les actions disponibles pour chaque table, vous allez maintenant utiliser 
le lien Structure (cliquez sur le lien Structure de la table cours, voir repere 2 figure 16-15). 
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Figure 16-15 

Pour acceder a l'ecran Structure d'une table, cliquez sur le nom de la base dans le cadre de gauche 
de V interface (voir repere 1 ) puis sur le lien Structure de cette table (voir repere 2). 



Modification ou suppression d'un champ 

L'ecran de la structure (voir figure 16-16) permet d'intervenir sur les caracteristiques de chaque 
champ de la table. Pour cela, il faut utiliser les icones des liens actifs a droite du champ a modifier. 

Voici les differentes fonctions de ces liens : 

• Afflcher - permet d'afficher les differentes valeurs des enregistrements du champ concerne ; 

• Modifier - permet de modifier les caracteristiques d'un champ ; 

• Supprimer - permet de supprimer completement le champ concerne ; 

• Primaire - definit le champ concerne comme cle primaire de la table ; 

• Index - definit le champ concerne comme une cle d'index. Une cle d'index permet d'augmenter 
les performances d'un tri ou d'une recherche si le champ est utilise comme critere ; 

• Unique - impose que le champ concerne prenne une valeur differente pour chacun des 
enregistrements ; 
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• Texte entier - permet Findexation et la recherche sur l'ensemble d'un champ « texte » (full text). 
Les index FULLTEXT sont utilises avec les tables MylSAM et peuvent etre crees pour des colonnes de 
types CHAR, VARCHAR OU TEXT. 
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Figure 16-16 

L'ecran des Proprietes de la table (onglet Structure) permet de selectionner Vaction a realiser et le champ 
concerne pour modifier la structure d'une table. 



Cliquez sur le lien Modifier situe sur la ligne du champ horai re de la table cours. La modification 
consiste a rendre ce champ facultatif : selectionnez null dans la colonne du meme nom (voir 
figure 16-17), puis cliquez sur le bouton Sauvegarder pour enregistrer votre modification. 

Ajout d'un champ 

Pour ajouter un nouveau champ a une table, il faut utiliser les deux zones prevues a cet effet en bas 
de l'ecran Structure (voir figure 16-18). Apres avoir indique le nombre de champs a ajouter et leur 
position dans la base par rapport aux champs actuels, vous accederez a un formulaire semblable a 
celui de la creation initiale d'une table. Validez-le apres F avoir renseigne. 
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Figure 16-17 

Leformulaire de modification des proprietes d'un champ vous permet d'intervenirfacilement sur ses differents 
attributs. 
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Figure 16-18 

Pour acceder auformulaire d'ajout de champ, vous devez utiliser la rubrique Ajouter un champ en bas 
de I 'ecran Structure. 
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Configuration des droits d'un utilisateur 

Fonctions des tables de la base mysql 

Les droits des utilisateurs du serveur MySQL sont deflnis dans la base mysql. Chaque table de cette 
base permet de configurer des droits d'acces plus ou moins restreints aux donnees pour un utilisateur 
specifique (voir figure 16-19). 



SERVEUR MYSQL 



droits geres 
par la table 
user 



BASE DE DONNEES 



droits geres 
par la table 
db 



droits geres 
par la table 
tables priv 
► 



TABLE 



COLONNE 



droits geres 
par la table 
columns_priv 



Figure 16-19 

Les droits des utilisateurs peuvent etre definis a differents niveaux du serveur de base de donnees. 
Les tables de la base mysql permettent de configurer ces parametres pour chaque utilisateur. 

Si vous selectionnez la base mysql dans le menu deroulant de Faccueil, la liste de ses tables apparait 
dans le cadre de gauche et les actions disponibles sur chacune de ces tables dans le cadre de droite. 
Le tableau 16-10 indique les fonctions de ces differentes tables. 



Tableau 16-10. Fonctions des tables de la base mysql 



Table 


Fonctions 


columns_priv 


Stocke les droits d'acces d'un utilisateur sur les colonnes d'une table. 


db 


Stocke les droits d'acces d'un utilisateur sur une base de donnees. 


host 


Permet de restreindre les droits en cas de connexion a partir d'un ordinateur particulier. 


tabl es_pri v 


Stocke les droits d'acces d'un utilisateur sur les tables d'une base de donnees. 


user 


Stocke les utilisateurs, leur mot de passe et les droits d'acces globaux. 



Pour acceder a la table user, cliquez sur le lien Afficher situe sur la ligne de la table user. Lors de 
l'installation, MySQL cree toujours un utilisateur root sans mot de passe, qui a tous les droits sur 
toutes les bases. Dans le contexte d'une utilisation en local avec Wamp 5 (pour le developpement de 
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votre application, par exemple), cela n'est pas dangereux. En revanche, sur un serveur distant, le mot 
de passe de l'utilisateur root dans la table user doit toujours etre renseigne. 

Nous pourrions configurer les droits d'un utilisateur directement dans les tables de la base mysql. 
Cependant, phpMy Admin met a votre disposition un assistant de creation d' utilisateur que nous 
allons detailler dans la section suivante. 



Creation d'un utilisateur MySQL en mode assiste 

Vous allez maintenant creer un nouvel utilisateur et parameter ses droits en configurant un compte 
utilisateur sport pour acceder exclusivement a la base sport_db (voir figure 16-20). 



Figure 16-20 

Schema de principe du 
contrdle d' acces d'un 
utilisateur sport a la base 
sport_db 



Ordinateur de developpement (localhost) 



Serveur MySQL 




Base score db 



Table adherents 



1 | Defrance 

2 Bertaut 

l -l 



Table cours 
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debutant 




2 


intermediaire 











Table professeurs 



1 Dupond 
: 'Tavan 



Acces au serveur MySQL : 
(Table USER) 

host : localhost 
user : sport 
password : eyrolles 
droits globaux :aucun 




Acces a la base sport_db : 
(Table DB) 

host : localhost 
db : sport_db 
user : sport 

droits sur la base : tous sauf supp. base 



Les parametres de ce compte seront repris par la suite pour configurer la « connexion a la base » utili- 
sed dans vos scripts PHP. Nous vous conseillons done d'utiliser les valeurs suggerees, arm d'eviter 
toute erreur de configuration par la suite. 
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Le compte root par defaut 

Si vous ne creez pas de compte utilisateur, vous pourrez quand meme configurer une connexion a la base en utili- 
sant le compte root preconfigure par defaut dans MySQL (dans ce cas, il faut remplacer dans le fichier de 
connexion le nom de I'utilisateur par root et ne pas indiquer de mot de passe). Attention ! I'usage de ce compte 
root sans mot de passe est evidemment limite a un usage local. Vous devez imperativement vous assurer que 
tous les comptes mysql possedent bien un mot de passe si votre base de donnees doit etre reliee a Internet. 



Placez-vous dans la page d'accueil du gestionnaire (cliquez sur l'icone representant une petite 
maison correspondant au lien Accueil dans la partie gauche de l'interface) puis cliquez sur le lien 
Privileges (voir figure 16-21). 
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Figure 16-21 

Le lien Privileges de Vecran d'accueil de phpMyAdmin permet d'acceder a ['assistant de creation 
d'un utilisateur. 



Dans la nouvelle fenetre, cliquez sur le lien Ajouter un utilisateur en bas du tableau des utilisateurs 
(voir figure 16-22). 

Saisissez le nom d'utilisateur sport et selectionnez 1 ocal host dans le menu deroulant Serveur. Saisis- 
sez ensuite deux fois le mot de passe correspondant a cet utilisateur (soit eyrol 1 es dans notre exem- 
ple) et cliquez sur le bouton Executez sans valider d' autre option (voir figure 16-23). Notez que si 
vous validez un droit a ce niveau (privileges globaux), cela permet a I'utilisateur de V exploiter sur 
toutes les bases du serveur MySQL et non exclusivement sur la base sport_db. 
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Figure 16-22 

Cet ecran affiche les 
utilisateurs existants de 
votre base de donnees. 
En cliquant sur le lien 
Creer un utUisateur, 
vous pouvez acceder 
au formulaire d'ajout 
d'un nouvel utUisateur. 
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Figure 16-23 

Powr ajouter un nouvel 
utUisateur, il suffit 
d'indiquer son nom, son 
serveur (en general 
localhost) et son mot de 
passe. 
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Apres validation, un ecran vous informe que le nouvel utilisateur sport@l oca! host (e'est-a-dire 
1' utilisateur sport depuis un acces 1 ocal host) a bien ete cree et vous propose de modifier eventuelle- 
ment ses attributions. Un peu plus bas, dans le meme ecran de confirmation, se trouve une rubrique 
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intitulee Privileges specifiques a une base de donnees. Selectionnez la base sport_db dans le menu 
deroulant (voir figure 16-24) pour acceder au formulaire d'ajout d'un privilege d'acces a la base 
sport_db. 
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Figure 16-24 

Apres V enregistrement du nouvel utilisateur, le gestionnaire ajfiche un ecran de confirmation qui indique que 
Vutilisateur sport® localhost a bien ete ajoute a la table utilisateurs. En bas de ce meme ecran, un menu 
deroulant permet de selectionner une base de donnees existante pour attribuer des privileges specifiques a 
I 'utilisateur sport. 



Cochez les droits que vous desirez attribuer a l'utilisateur pour la base concernee (par exemple, auto- 
riser tous les droits relatifs aux donnees et a la structure mais pas a 1' administration) puis validez en 
cliquant sur le bouton Executer (voir figure 16-25). 

Les droits de l'utilisateur sport sont desormais configures pour acceder exclusivement a la base 
sport_db. Si vous consultez ensuite la vue d'ensemble des utilisateurs (cliquez sur l'onglet Privileges 
en haut de l'ecran), vous constatez qu'un nouvel utilisateur sport s'affiche (voir figure 16-26). 
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Figure 16-25 

tableau des privileges specifiques a une base de donnees permet de definir un droit d'acces a une base specifique. 
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Figure 16-26 

Dans la vue d'ensemble des utilisateurs, on constate que Vutilisateur sport est desormais configure. 
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Sauvegarde et restauration d'une base de donnees 

II est hautement recommande de faire une sauvegarde de secours de ses programmes et il en est de 
meme pour les bases de donnees. Cependant, la demarche est quelque peu differente, car nous 
n'allons pas copier un simple fichier, mais enregistrer les requetes MySQL qui ont ete utilisees pour 
creer la structure de la base et eventuellement celles qui ont permis d'inserer des enregistrements 
dans les tables. Une fois enregistrees dans un fichier, ces requetes pourront ensuite etre utilisees dans 
phpMy Admin pour recreer a Fidentique la base sauvegardee. 

Sauvegarde 

Passons maintenant a la pratique. Pour cela, vous allez commencer par vous assurer que la base a 
sauvegarder est bien selectionnee dans la liste deroulante de gauche (voir repere 1 de la figure 16-27). 
Dans la partie droite, cliquez sur Fonglet Exporter situe en haut de Fecran (voir repere 2 de figure 16-27). 
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Figure 16-27 

Pour sauvegarder une base, on utilise le formulaire de la rubrique Exporter. 
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La nouvelle page de droite contient plusieurs cadres. Le premier, intitule Exporter, permet de selec- 
tionner les tables a exporter et le format d' exportation. Selectionnez toutes les tables en cliquant sur 
le lien Tout selectionner (voir repere 3 de la figure 16-27) et conservez le format SQL initialise par 
defaut. Le second cadre, intitule options SQL, vous permet d'ajouter un DROP TABLE (pour ce faire, 
cochez l'option portant le meme nom dans le cadre secondaire nomme Structure : voir repere 4 de la 
figure 16-27) qui supprimera automatiquement les anciennes tables de la base avant d'y inclure les 
nouvelles, ce qui evite de generer un message d'erreur si une table de meme nom existait deja. C'est dans 
ce meme cadre que Ton peut choisir d' exporter la structure, les donnees ou les deux ensembles (dans 
notre cas, nous validerons les deux). Le troisieme cadre, intitule Transmettre, vous permet d'indiquer que 
vous desirez generer un fichier (pour ce faire, cliquez dans la case a cocher intitulee Transmettre : voir 
repere 5 de la figure 16-27) et de choisir le type de compression a utiliser (choisissez l'option Aucune). 
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Validez en cliquant sur le bouton Executer place en bas de Fecran. Une premiere fenetre vous 
demande de confirmer Fenregistrement (cliquez sur Enregistrer pour confirmer). Un deuxieme ecran 
(voir figure 16-28) vous demande de selectionner le repertoire de sauvegarde. Verifiez Femplace- 
ment du repertoire qui vous est propose par defaut ou choisissez un repertoire dedie aux archives de 
votre projet, arm de savoir ou retrouver votre fichier lors de la restauration (vous pouvez par exemple 
creer un repertoire archives a la racine de votre site Web et creer dans celui-ci un repertoire sql qui 
regroupe toutes les sauvegardes de votre base de donnees). Apres validation, Fenregistrement s'effectue. 
Nous vous suggerons d' utiliser l'explorateur Windows pour vous assurer que le fichier est bien enre- 
gistre a Fendroit indique. Si vous ouvrez ce fichier sport_db.sql avec un simple editeur (Bloc-notes, 
par exemple), vous devez retrouver les requetes destinees a recreer des structures de tables conformes 
a Forigine (CREATE TABLE), puis a provoquer des ajouts d'enregistrements dans les tables (INSERT INTO) 
selon les valeurs actuellement presentes dans la base : 



Restauration 

Pour restaurer une base, il faut que celle-ci soit deja creee (revoir si besoin la procedure de creation 
d'une base). Ensuite, selectionnez-la dans la liste de gauche et cliquez sur le nom d'une des tables de 
cette base. 
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A noter 

La base sport_db doit etre creee, mais peut etre vide de toute table. Si ce n'est pas le cas, nous vous invitons a 
supprimer les tables pour bien comprendre la procedure de restauration (pour supprimer une table, cliquez sur le 
lien Supprimer correspondant). 



Dans la partie droite, cliquez sur l'onglet Importer en haut de Fecran (voir repere 1 de la figure 16-29). La 
nouvelle page propose un formulaire vous invitant a selectionner le fichier a importer. Cliquez sur le 
bouton Parcourir (voir repere 2 de la figure 16-29). Selectionnez ensuite, dans l'explorateur, le fichier 
precedemment sauvegarde et cliquez sur Ouvrir pour valider votre choix. Le chemin du fichier est 
alors copie dans le champ a gauche du bouton Parcourir (voir repere 3 de la figure 16-39). II ne vous 
reste plus qu'a cliquer sur le bouton Executer pour demarrer la restauration. Toutes les requetes du 
fichier s'executent alors et s'affichent en haut de l'ecran. Au terme de la restauration, les tables de la 
base sont de nouveau visibles dans le gestionnaire. 



3 local host 


/ localhosl / '-[tor t dtj / ddhcrents | phpMyAdmtn 2. 7.0-pll - Microsoft Inlet net fixplorer 


- n x : 


: RdVer Edfoon Affxhage Favors Outfc > t' IT 


g Prfc* 




» H« ^ 1 




B 3 Ql < 

j aKsrei ■ ..- Foones ajtonubques • \ \ Q O ij -4 O ii J 3» 

A 12,4m U 18 Cd 30 



Figure 16-29 

Pour la restauration d'une base de donnees, ilfaut utiliser le formulaire de la rubrique Importer en precisant 
I 'emplacement du fichier de restauration sport _db. sql. 
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Le langage SQL (Structured Query Language) est un langage normalise d'interrogation de bases de 
donnees. Puisqu'il est normalise, il est independant du type des bases de donnees : les memes 
commandes peuvent done etre exploiters quelle que soit la base utilisee (Access, MySQL...). 
Les commandes SQL peuvent ainsi gerer tout type d' action sur le serveur de bases de donnees 
MySQL, depuis la simple manipulation des enregistrements jusqu'a la creation, la modification ou la 
suppression d'une base, d'une table ou d'un champ. 



Methodes d'execution d'une commande SQL 

Les commandes SQL peuvent etre transmises au serveur MySQL de deux manieres selon Taction 
qu'on desire realiser (voir tableau 17-1). 

La premiere maniere consiste a utiliser un logiciel comme le gestionnaire phpMy Admin ou encore le 
client mysql (qui permet la saisie de commandes directement sur le serveur). Cependant, ces outils 
necessitent de disposer d'un compte administrateur sur le serveur de la base et demandent un appren- 
tissage prealable. En pratique, nous les utiliserons uniquement dans le cadre de la creation ou de la 
modification de la structure d'une base de donnees. 

La deuxieme maniere consiste a utiliser des scripts PHP dont la fonction est d'assurer l'interfacage 
avec la base de donnees MySql. Ces derniers envoient des requetes a la base selon les demandes 
qu'ils receptionnent (a l'aide d'un formulaire en ligne ou d'une animation Flash, par exemple). 
Les resultats des requetes sont ensuite mis en forme et transmis a une application specifique (page 
PHP ou animation Flash configurees pour afficher les resultats). Cette deuxieme methode permet 
de creer des interfaces client adaptees aux besoins d'une application et utilisables en ligne 
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sans authentification prealable de l'utilisateur. La creation de ces interfaces sera traitee dans le 
chapitre 18. 



Tableau 17-1. Tableau de choix d'une methode pour intervenir sur une base de donnees 



Commandes 


Actions 


Methode conseillee 


Chapitre 
a consulter 


CREATE 

ALTER 

DROP 


Creation 
ou modification 
d'une base ou 
d'une table 


Gestionnaire phpMyAdmin : 

Interface graphique qui permet de generer tout type de commande 
SQL. 

En pratique, le gestionnaire est utilise pour creer ou modifier la 
structure de la base (CREATE, ALTER, DROP) ou pour tester des 
requetes (SELECT...) en phase de mise au point des scripts PHP 
(necessite un compte administrateur). 


Chapitre 16 






Client MySQL : 

Meme utilisation que le gestionnaire phpMyAdmin mais en mode 
lignes de code. L'utilisation du client MySql necessite de connaitre 
toutes les syntaxes SQL, contrairement a I'interface graphique pre- 
sentee ci-dessus (necessite un compte administrateur). 


non aborde 
dans cet 
ouvrage 


SELECT 
INSERT 
UPDATE 
DELETE 
REPLACE 


Manipulationsdes 
enregistrements 
(donnees) des 
differentes tables 
d'une base 


Script PHP d'interfacage MySql : 

Scripts PHP crees dans un editeur de code dont la fonction est 

d'assurer I'interfacage avec la base de donnees. 

Ces scripts repondent exactement aux besoins de I'application et 

peuvent generer tout type de commande SQL mais en pratique ils 

sont surtout utilises pour gerer les enregistrements des tables 

(SELECT...). 


Chapitre 18 



Dans ce chapitre dedie aux commandes SQL avancees, nous nous interesserons uniquement a la 
redaction des requetes destinees a la manipulation des donnees (SELECT, INSERT, UPDATE, DELETE et 
REPLACE). Nous ne creerons pas de requetes pour la creation ou la modification de la structure de la 
base de donnees car nous utiliserons pour ce faire le gestionnaire de base phpMyAdmin en suivant les 
procedures presentees dans le chapitre 16. 

Dans le chapitre 18, consacre aux interfacages Flash-PHP-MySql, nous etudierons les differentes 
fonctions PHP qui permettent d'integrer une commande SQL dans un script PHP. Dans le present 
chapitre, nous nous limiterons a F etude des commandes SQL. 

Le tableau 17-2 presente les differentes commandes SQL destinees a la manipulation de 
donnees, leur fonction et leur syntaxe simplifiee. Nous completerons plus loin ces informations 
par une syntaxe detaillee des commandes. Chaque commande sera accompagnee de plusieurs 
exemples. 
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Tableau 17-2. Principales commandes SQL de manipulation d'enregistrements 



Commande SQL 


Fonction 


Syntaxe simplifiee 


SELECT 

(commande utilisee 
pour tous les jeux 
d'enregistrements) 


Recherche et extraction de donnees. Differentes 
options peuvent etre exploiters pour selectionner les 
enregistrements, les champs retournes ou I'ordre 
dans lequel sont retournes les enregistrements. 


SELECT champl, champ2, ... 
FROM tablel, table2, ... 
WHERE critere(s) de selection 
ORDER BY information sur le tri 


Commande SQL 


Fonction 


Syntaxe simplifiee 


INSERT 


Ajout d'enregistrement(s) dans la base 


INSERT INTO table (champl, champ2, ...) 
VALUES (valeurl, valeur2, ...) 


UPDATE 


Modification d'enregistrement(s) 


UPDATE table 

SET champ = valeur 

WHERE critere(s) de selection 


DELETE 


Suppression d'enregistrement(s) 


DELETE FROM table 

WHERE critere(s) de selection 


REPLACE 


Remplacement d'enregistrement(s) 
(equivaut aux commandes DELETE et INSERT 
executees successivement) 


REPLACE FROM table 

WHERE critere(s) de selection 



Conditions de test des exemples de commande SQL 

Tous les exemples de ce chapitre ont ete testes sur la base de donnees sport_db et a l'aide du gestion- 
naire phpMy Admin. Afin que vous compreniez bien les specificites de chaque clause, nous vous 
suggerons de realiser chacun de ces exemples. Pour cela, ouvrez le gestionnaire phpMy Admin et 
selectionnez dans le cadre de gauche la base sport_db (voir repere 1 de la figure 17-1) que nous avons 
creee precedemment (revoir si besoin le chapitre 16). Cliquez ensuite sur l'onglet SQL (voir repere 2 
de la figure 17-1), saisissez la requete a tester dans le champ Executer une ou des requetes (voir 
repere 3 de la figure 17-1) et cliquez sur le bouton Executer (voir repere 4 de la figure 17-1). Vous 
pouvez ainsi vous aider de la liste des champs du tableau de droite en les inserant directement dans 
votre requete par un simple double-clic. 



A noter 

phpMyAdminajouteraautomatiquement a la requete saisie une clause LIMIT (exemple : LIMIT 0.30) pourlimiter 
le nombre d'enregistrements affiches. Ne soyez done pas surpris de voir apparaitre cette clause dans les differentes 
illustrations presentees dans ce chapitre. 



D'autre part, afin de partir d'une base de test commune et de pouvoir interpreter correctement les 
resultats des exemples que nous vous presentons dans ce chapitre, nous vous indiquons dans les 
figures 17-2 a 17-4 l'etat des enregistrements des differentes tables de la base sport_db qui ont servi 
a nos essais. 
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3 localhost / local host / sporl_db / adherents | phpMyAdmin 7.7,0 pl1 Microsoft Internet Explorer 



FJchJer EoVtlon Sfflchaot Favors Qubfe > 



i 



p*ip- 




I Seivem: localhost > 



i ilounees: spoit_db ► ED) Table: adheients "InnoDBIree 4096 kB" 



TAHlchei EJ 


J SttiiLiutA 


»J?S0L V Recheichei >c)tiserei djExpoiter (J 


llmpoitei 


^Operations 


SVidei 







tqu4t— sur la base sport_db: fl) • 




Conserver cette requeue dans les signets 



G Remplacer urt signet existant du meme nom 



□ Signet visible pour les autres utilisateurs 
4 



B Reaffichet la requete apres execution 




»J Intranet local 



Figure 17-1 

Procedure de test d'une requete SQL dans phpMyAdmin 



3 localhost / localhost / sport„db / adherents | phpMyAdmin 2.7. 0-pll - Microsoft Internet Explorer 



Fjchrar ErJbon gffichage Fayoris Qutfe J 



ft 



Base de donnees 



sport.db (3) 



adherents 
oours 

professeurs 



i 



Afficher : "| (x enregistrement(s) a partir de I'enregislrement n* 15" 



en mode honzontal 



v | et repeter les en ietes a chaque groupe de |100 



Trier sur Hndex aucune 



Executet ] 



-T- 


10 couisID 


nom prenom 


anneeNaissance 


□ 


✓ X 


1 2 


Defrance Jean-Mane 


1960 


□ 


✓ X 


2 1 


Bertaut Genevieve 


1965 


□ 


✓ X 


3 1 


Dumoulin Alice 


1960 


□ 


✓ X 


4 2 


Chapelier Roland 


1968 


□ 


✓ X 


5 3 


Chauvier Christian 


1972 


□ 


✓ X 


6 3 


Hamond Laurence 


1983 



Tout cocher / Tout decocher Pour la selection jf ¥• ull 

] |30 enregistrement(s) a partir de I'enregislrement n* jo" 



Afficher 



en mode horizontal 



v et repeter les en-tetes a chaque groupe de |100 



1< Inserer un nouvel enregistrement ^ Version impnmable Version impnmable (avec textes 
complets) US Exporter 

»J Intranet local 



Figure 17-2 

Affichage des enregistrements de la table adherents utilises dans nos exemples 
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3 localhost / localhost / spori rib / adherents | phpMyAdmin 2.7.0-pM - Microsoft Internet Explorer 



Fjchier EoWon Sffichaoe Favors 2utfc I 



laiaiai 



Adresse [Q http:/ftxat»wt;ptipmy«trtn; 



st n □ 



Base de donnees 



sport.db (3) 



adherents 
cours 

professeurs 



| Afficher: 1 130 
en mode I horizontal 



enregislrement(s) a partir de I'enregistrement n° |0 

J| at nipeter les en-tetes a chaque groupe de 1 1 00 



Trier sur I'mdex 


aucune 




V 


[ Execuler 






ID comsID 


nom 


pienom 


• ir ri -i i---..> 


□ 


✓ 


X 


1 2 


Defrance 


Jean-Marie 


I960 


□ 




X 




Bertaut 


Genevieve 


1965 


□ 




X 


3 1 


Dumoulin 


Alice 


1960 


□ 




X 


4 


2 


Chapelier 


Roland 


1968 


□ 


✓ 


X 


5 


3 


Chauvier 


Christian 


1972 


□ 


✓ 


X 


E 


3 


Hamond 


Laurence 


1963 



. Tout cocher / Tout decocher Pour la sileclion : jf >< HE 
[ Afficher : | po enregistrement(s) a partir de I'enregistrement n° [6~~ 



en mode horizontal 



v et repeter les en-tetes a chaque groupe de pOO 



«-J Intranet kxal 



Figure 17-3 

Affichage des enregistrements de la table cours utilises dans nos exemples 



J localhost / localhost / spori rib / professeurs [ phpMyAdmin 2.7.0 p(1 ■ Microsoft Internet Explorer 



FIcNer Edition Atfichage Favpns Qutfc j 



Adresse iQhttp://Vxatic«t/pr^admln/ 



ft 



HI 



Base de donnees 

I sport_db (3) 



SI adherents 

El cours 

El professeurs 



a 



Afficher : "] [36 enregistrement(s) a partir de I'enregistrement n*(5~ 



en mode horizontal 



v et repeter les en-tetes a chaque groupe de 1 1 00 



Trier sur I'mdex i aucune 



-T- 


ID 


nomPiof 


prenomProf 


tel 


□ 


✓ 




i 


Oupond 


Alain 


0145636600 


□ 




x 


2 


Tavan 


Jean-Pierre 


0173653941 



Tout cocher / Tout decocher Pour la selection j? Y BI 

J [30 enregistrement(s) a partir de I'enregistrement n° f}~ 



Afficher 



en mode horizontal 



v et repeter les en-tetes a chaque groupe de |l00 



» J Intranet local 



Figure 17-4 

Affichage des enregistrements de la table professeurs utilises dans nos exemples 
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Commande SELECT 

La commande SELECT permet de rechercher puis d'extraire les champs demandes d'une ou plusieurs 
tables selon un ou plusieurs criteres. Les resultats ainsi retoumes forment des « jeux d'enregistrements ». 
Ceux-ci peuvent etre tries ou groupes selon les options retenues dans la requete SELECT. 

SELECT est une commande frequemment utilisee dans les manipulations d'enregistrements courantes ; 
il est done tres important de bien maitriser toutes ses variantes si vous desirez concevoir des requetes 
SQL avancees. 

Differentes clauses peuvent completer la commande SELECT afin de preciser 1' operation a realiser. Par 
exemple, la clause WHERE permet de selectionner les enregistrements a extraire. La clause ORDER BY 
permet quant a elle de trier les resultats apres leur selection. Nous vous proposons de detailler ces 
differentes clauses et de les illustrer par des exemples. 



Tableau 17-3. Syntaxe de la commande SELECT et exemples d'utilisation 



Selection d'enregistrements 


Syntaxe 


SELECT [DISTINCT | DISTINCTROW] 


detaillee 


[table. ]champ, ... | * 




[FROM table. ...] 




[WHERE expression_de_sel ection] 




[GROUP BY [table. ]champ, ...] 




[HAVING express ion_de_sel ection] 




[ORDER BY champ [ASC | DESC] ] 




[LIMIT [debut,] nbjignes ] 


Legende 


[xxx] : le code xxx est facultatif. 




(Attention ! Les crochets [ et ] ne doivent surtout pas etre saisis dans le code.) 




xxx | yyy : le code « | » separe des groupes de code alternatifs (il faut done choisir de saisir soit xxx, soit 




yyy)- 




xxx ... : la suite du code peut etre completee par des groupes de code de meme structure que xxx. 


Exemples 


Exemple 1 : 




SELECT * FROM adherents 




Exemple 2 : 




SELECT nom FROM adherents WHERE nom='Defrance' 




Exemple 3 : 




SELECT adherents .nom, cours. niveau 




FROM adherents, cours 




WHERE adherents . coursID=cours . ID 



Commande SELECT simple 

Dans sa forme la plus simple, la commande SELECT peut etre employee sans la clause WHERE. Dans ce 
cas, en l'absence d'expression de selection, tous les enregistrements de la table sont retournes. Pour 
inclure uniquement certaines colonnes dans le resultat, il faut les enumerer apres la commande 
SELECT. S'il y a plus d'une colonne a retourner, il faut separer les differents noms des colonnes par 
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une virgule. Enfin, si des champs de meme nom issus de tables differentes peuvent etre ambigus, il 
est indispensable de les faire preceder du nom de la table a laquelle ils appartiennent afin de lever 
l'ambiguiite. Enfin, il est possible de remplacer 1' enumeration des colonnes desirees par le caractere 

• : toutes les colonnes de la table sont alors retournees dans le resultat de la requete. 

Voici quelques exemples : 

• pour obtenir tous les champs de tous les adherents : 
SELECT * FROM adherents 

• pour obtenir uniquement les noms et prenoms de tous les adherents (voir figure 14-5) : 
| SELECT nom, prenom FROM adherents 



U localhost / localhost / sport db / professeurs | phpMyAdmin 2.7.0 p!1 Microsoft Internet Explorer 



Fichcer t*wi tfhehage Favorts fijtfc 



(^Precedent. • © • 3 [3 Cii j Afrwst |f] httpr/Zbutost/phpnyadrMV 



php.. 



\a\mmm 



Base de donnees 



, sport_db (3) 



II adherents 

B cours 

S professeurs 



9 Serveui: localhost ► ©> Base de donnees: sporf_db ► H Table: professeurs 
■InnoDB free 4096 kB' 

"TAfficftei EffStiuctuie t&SOL s Rechetcher 3Klnseiet flliExpoiter Bjjlmpottet 
^Operations BVidei XSuppiimi-i 



Affichaoe des enteqisltements 0 • 5 (6 total, traitemenl: 0 0002 sec ) 



— requete SQL ^ 




SSJiCT nom. prenom \ 




FROM adherents J 




UMffO.30 y 




I | Modifier | [ Expliquer SQL 1 1 Creer source PHP 1 1 Actualiser | 



30 



en mode ho 
Tfier^jfrindex: aucune 





nom 


prenom 


□ 


✓ 


X 


Defrance 


JearvMarie 


□ 


y 


X 


Bertaut 


Genevieve 


□ 


s 


X 


Dumouhn 


Alice 


□ 


s 


X 


Chapelier 


Roland 


□ 


s 


X 


Chauvier 


Christian 




J? 


X 


Hamond 


Laurence 



enregistrement(s) a partir de lenregistremenl n* jo* 

I et repeter les en-tetes a chaque groupe de 1 1 00 
" | E»ecuter~] 



Tout cocher/Tout decocher Bdvr la selection - S X I 



fnregistrement(s) a partir de I'enregistrement n* jo 



en mode horizontal 



v et repeter les en-tetes a chaque groupe de j 1 00 



*J Intranet tocal 



Figure 17-5 

Test realise avec un jeu d'enregistrements : requete simple 
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Commande SELECT avec des alias 

II est souvent pratique de definir des noms alias differents des noms des champs de la base. On peut 
s'en servir pour definir des expressions de selection ou encore lorsqu'on utilise des fonctions, comme 
nous allons le voir. Pour definir un nom de champ alias, il suffit de faire suivre 1' expression qu'il 
represente par 1' instruction AS et par le nom de 1' alias desire. 

Par exemple, voici la commande a saisir pour obtenir tous les identifiants des adherents sous 1' alias 
idl, ainsi que leur nom (voir figure 17-6) : 

SELECT adherents . ID AS idl, nom FROM adherents 



3 locathost / localhost / sport^db / adherents [ phpMyAdmin 2.7.0-pl1 • Microsoft Internet Explorer 




Figure 17-6 

Test realise avec un jeu d'enregistrements : requite avec alias 
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Commande SELECT avec des fonctions MySQL 

De nombreuses fonctions MySQL peuvent etre utilisees dans les requetes. Elles se substituent au 
nom d'un champ juste apres la commande SELECT. Ces fonctions permettent, entre autres, de realiser 
des calculs mathematiques ou des concatenations. Elles servent aussi a preparer une date (enregistree 
dans la base au format MySQL : AAAA-MM-JJ) arm qu'elle soit retournee et affichee au format francais 
(JJ-MM-AAAA). Le tableau 17-4 propose une liste non exhaustive des fonctions MySQL disponibles. 



Tableau 17-4. Liste non exhaustive des principales fonctions MySQL 



Fonction 


Description 


ABS(nbrl) 


Renvoie la valeur absolue du nombre nbrl. 


ASCU(carl) 


Renvoie le code ASCII du caractere carl. 


AVG(chl) 


Renvoie la moyenne arithmetique des valeurs du champ chl. 


CONCATteleml, [elem2, ...] ) 


Renvoie la concatenation de tous les elements, un element pouvant etre un champ, un 
nombre ou un caractere. Si c'est un caractere, il convient de I'encadrer avec des guillemets 
simples. 


COUNT(chl) 


Renvoie le nombre d'enregistrements non nuls du champ chl. A noter : Si on utilise 
COU NT ( * ) , on obtient le nombre total d'enregistrements de la tab le, quel que soit le champ. 


CURDATEO 


Renvoie la date courante au format AAAA-MM-JJ. 


CURTIMEO 


Renvoie I'heure courante au format HH:MM: SS. 


ENCRYPT(chaine[,cle]) 


Renvoie la chaine cryptee, avec la cle si elle est precisee. 


HEX(nbrl) 


Renvoie la valeur hexadecimale du nombre nbrl. 


IFNULL(eleml.elem2) 


Renvoie el eml s'il est NULL ; sinon renvoie el em2. 


LAST_INSERT_ID() 


Renvoie la derniere valeur creee pour un champ auto-incremente. 


MAX(chl) 


Renvoie la plus grande des valeurs du champ chl. 


MIN(chl) 


Renvoie la plus petite des valeurs du champ chl. 


NOWO 


Renvoie la date et I'heure courantes. 


PASSWORD(chaine) 


Renvoie la valeur cryptee de chai ne avec la fonction utilisee pour les mots de passe de 
MySQL. 


REVERSE(chaine) 


Renvoie I'expression miroir de la chaine. 


SIGN(eleml) 


Renvoie le signe de el eml. 


SUM(chl) 


Renvoie la somme des valeurs du champ chl. 


TRIM(chaine) 


Renvoie la valeur de chat ne apres avoir elimine les espaces places au debut et a la fin. 


USERO 


Renvoie le nom de I'utilisateur courant. 


VERSIONO 


Renvoie la version de MySQL. 
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Lorsqu'on utilise des fonctions MySQL, il est tres pratique de definir un nom de champ alias pour 
exploiter le resultat de la fonction a partir du jeu d'enregistrements. 

Dans l'exemple qui suit, on desire obtenir les numeros de telephone des professeurs prefixes avec 
« +33 » pour preciser Findicatif a utiliser a l'etranger. Pour manipuler plus facilement les donnees 
ainsi creees, on definit un alias nomme tel Etranger pour representer ce nouveau champ dans le jeu 
d'enregistrements (voir figure 17-7) : 

SELECT nomProf, CONCATC '+33' ,tel ) AS telEtranger FROM professeurs 



3 localhost / localhost / sport__db / adherents | phpMyAdmin 2.7.0 pl1 ■ Microsoft Internet Explorer 



fierier W*lon fi/fichaoe Fajoris Quite J 
\ Qpr&edente - Q \h\ g) 



Ad/esie hHp:/^x:atioa;phpinYadinln/ 



p/>p~. ^ 



fl □ Q Q 



Base de donnees 



| sport.db (3) 



m adherents 

B cours 

S professeurs 



Serveur: localhost ► @ Base de donnees: spoit_db ► [3 Table: adherents "fnnoDB free: 4096 kB' 

uHAfficher EffStiuctuie ^SQL >- Recherchei B*lnserer ISiExporter flfilmporter 
^Operations BVider ESupprimer 



Aflichage des enregistrements 0 - 1 (2 total, traitement: 0-4428 sec.) 




Afficher j |5o enregistrement(s) a partie de I'enregistrement n° |o 



en mode horizontal 



et repeter les ervtetes a chaque groupe de |100 



4£|Terrr«ne 



*j Intranet local 



Figure 17-7 

Test realise avec un jeu d'enregistrements : requite avec la fonction CONCAT() 



Commande SELECT avec la clause DISTINCT 

Si, dans les resultats selectionnes, deux enregistrements sont identiques, la clause DISTINCT permet de 
ne retourner dans le jeu d'enregistrements qu'un seul des enregistrements. 

Dans les exemples ci-dessous, nous posons l'hypothese que deux enregistrements identiques 
(Bertaut Genevieve) ont ete crees dans la table adherents (pour faire un test, il suffit, par exemple, de 
remplacer au prealable les nom et prenom de l'adherente Dumoulin Alice par ceux de l'adherente 
Bertaut Genevieve). 
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Si on n'utilise pas la clause DISTINCT, void ce qu'on obtient : 
| SELECT nom. prenom FROM adherents 

Tableau 17-5. Jeu d'enregistrements obtenu sans la clause DISTINCT 



nom 


prenom 


Def ranee 


Jean-Marie 


Bertaut 


Genevieve 


Bertaut 


Genevi eve 


Chapel ier 


Rol and 





Avec la clause DISTINCT, le resultat devient le suivant : 
| SELECT DISTINCT nom, prenom FROM adherents 

Tableau 17-6. Jeu d'enregistrements obtenu avec la clause DISTINCT 



nom 


prenom 


Def ranee 


Jean-Marie 


Bertaut 


Genevieve 


Chapel ier 


Rol and 





Commande SELECT avec la clause WHERE 

La clause WHERE permet d'introduire F expression de selection a laquelle doit repondre le resultat 
retourne. Plusieurs types d'operateurs peuvent etre utilises pour definir l'expression de selection. 

Expressions de selection avec des operateurs de comparaison 

On utilise des operateurs de comparaison pour definir la condition mathematique a verifier pour que 
l'enregistrement soit selectionne. Vous pouvez comparer deux champs de la base (cas des jointures), 
un champ et un nombre ou un champ et une chaine de caracteres (dans ce cas, la chaine de caracteres 
doit etre encadree par des guillemets simples « ' »). 

Tableau 17-7. Liste des operateurs de comparaison qui peuvent etre utilises 

dans une requete SQL 











= Egal 


r> 


Superieur 
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Tableau 17-7. Liste des operateurs de comparaison qui peuvent etre utilises 
dans une requete SQL (suite) 



Operateur 


Fonction 


>= Superieur ou egal 


< 


Inferieur 


<= 


Inferieur ou egal 


<> 


Different 



Dans l'exemple qui suit, nous desirons obtenir une selection des adherents nes avant 1975. Les colon- 
nes renvoyees dans le jeu d'enregistrements seront le nom de l'adherent et son annee de 
naissance (voir figure 17-8) : 

| SELECT nom, anneeNaissance FROM adherents WHERE anneeNaissance<1975 
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- requite SOL 

SELECT nom. anneeNaissance 
FROM adherents 
WHERE anneeNaissance *1 975 
LIMIT 0 . 30 
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Figure 17-8 

Test realise avec un jeu d'enregistrements : requete avec la clause WHERE anneeNaissance<l 975 
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Dans ce deuxieme exemple, nous desirons obtenir toutes les colonnes de Fenregistrement correspon- 
dant a 1' adherent dont le nom est egal a Bertaut (n'oubliez pas d'encadrer le nom par des guillemets 
simples) (voir figure 17-9) : 

SELECT * FROM adherents WHERE nom=' Bertaut' 
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Figure 17-9 

Test realise avec un jeu d ' enregistrements : requete avec la clause WHERE nom= 'Bertaut' 



Dans ce troisieme exemple, nous desirons obtenir le nom de F adherent dont Fidentifiant est egal a 2 
(dans notre exemple, il s'agit de Fadherente Bertaut Genevieve), ainsi que le niveau de son cours. 
Comme les informations sont placees dans deux tables differentes, il faut faire une jointure entre les 
deux tables (voir la section consacree a la commande SELECT avec jointure dans ce meme chapitre) 
pour recuperer les informations correspondantes (adherents. coursID=cours. ID). Si des champs de 
tables differentes sont utilises dans la requete, les noms des tables concernees doivent etre ajoutes 
apres Finstruction FROM (voir figure 17-10) : 

SELECT adherents. nom, cours. niveau FROM adherents, cours 
WHERE adherents. coursID=cours. ID AND adherents . ID=2 
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- requeue SQL 

SELECT adherents norm cours nrveau 
FROM adherents, cours 
WHERE adherents coursID = cours ID 
AND adherents ID =2 
LIMIT 0 . 30 
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Figure 17-10 

Test realise avec un jeu d 'enregistrements : requite avec la clause WHERE adherents. courslD=cours. ID AND 
adherents. ID=2 



Expressions de selection avec des operateurs logiques 

Lorsque les criteres de selection sont multiples, l'expression de selection finale doit etre composee 
des differentes expressions de selection, reliees entre elles par des operateurs logiques. Plusieurs 
operateurs logiques peuvent etre utilises selon le lien desire entre les expressions. Vous trouverez ci- 
apres la liste des operateurs logiques utilisables dans une requete MySQL. 



Tableau 17-8. Liste des operateurs logiques qui peuvent etre utilises 
dans une requete SQL 



Operateur 


Fonction 


AND 




Les expressions reliees entre elles par AND doivent toutes etre verifiees (VRAI ou TRUE). 


OR 


Au moins Tune des expressions reliees entre elles par OR doit etre verifiee (VRAIE ou TRUE) 


NOT 


L'expression precedee par NOT ne doit pas etre verifiee. 


Si vous utilisez plusieurs operateurs logiques, il faut utiliser des parentheses pour definir la structure de l'expression. 
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Dans l'exemple suivant, nous desirons obtenir les noms et prenoms des adherents du cours des debu- 
tants nes apres 1970 (en faisant reference a la cle primaire de la table cours soit cours ID) (voir 
figure 17-11) : 

SELECT nom, prenom FROM adherents WHERE coursID=l AND anneeNaissance>1970 
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Figure 17-11 

Test realise avec un jeu a" enregistrements : requete avec la clause WHERE coursID=l AND 
anneeNaissance >1975 



Dans ce deuxieme exemple, nous desirons obtenir les nom et prenom des adherents du cours des 
debutants ou de perfectionnement nes apres 1970, (voir figure 17-12) : 

SELECT nom, prenom FROM adherents WHERE (coursID=l OR coursID=3) 
*»AND anneeNai ssance>1970 
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Figure 17-12 

Test realise avec un jeu d'enregistrements : requite avec la clause WHERE (coursID=l OR coursID=3) AND 
anneeNaissance >1970 



Dans ce troisieme exemple, nous desirons obtenir les nom et prenom de tous les adherents, sauf ceux 
nes en 1980 (done, dans notre cas, sauf Dumoulin Alice), (voir figure 17-13) : 

SELECT nom, prenom FROM adherents WHERE NOT (anneeNaissance=1980) 



Expressions de selection avec des operateurs de recherche 

On utilise des operateurs de recherche pour definir une condition specifique (qui n'est ni logique ni 
de comparaison) a verifier pour que I'enregistrement soit selectionne. II existe plusieurs types 
d' operateurs de recherche selon la condition desiree. 
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Figure 17-13 

Test realise avec un jeu d'enregistrements : requite avec la clause WHERE NOT (anneeNaissance= 1980) 



Le tableau 17-9 liste les operateurs de recherche les plus frequents. 

Tableau 17-9. Liste des operateurs de recherche qui peuvent etre utilises 
dans une requete SQL 



Operateur 


Fonction 


LIKE 


Permet de selectionner un champ dont lavaleur commence par, finit par ou contient une chaine de carac- 
teres (% et _ accompagnent souvent LI KE pour definir les caracteres de substitution dans la chaine). 


BETWEEN 


Permet de selectionner un champ dont la valeur est comprise dans une plage de valeurs. 


IN 


Permet de selectionner un champ dont la valeur appartient a une liste de valeurs. 


IS NULL 


Permet de selectionner un champ dont lavaleur est NULL. 


IS NOT NULL 


Permet de selectionner un champ dont lavaleur n'est pas NULL. 
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Dans l'exemple suivant, nous desirons obtenir la liste des adherents nes entre 1962 et 1970 (voir 
figure 17-14) : 

SELECT nom, prenom FROM adherents WHERE anneeNai ssance BETWEEN 1962 AND 1970 

Tableau 17-10. Caracteres de substitution qui peuvent etre utilises 
dans une requete SQL 

Caractere Utilisation 

(caractere de soulignement) Remplace un caractere quelconque. 
% Remplace aucun ou plusieurs caractere(s) quelconque(s). 
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Figure 17-14 

Test realise avec un jeu a" enregistrements : requete avec la clause WHERE anneeNaissance BETWEEN 1962 AND 
1970 
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Dans ce deuxieme exemple, nous desirons obtenir tous les enregistrements des adherents dont le nom 
commence par un D (voir figure 17-15) : 

SELECT * FROM adherents WHERE nom LIKE '0%' 



.1 locdlhost / localhost / sport db / adherents | phpMyAdmin 2. 7.0 p 1 1 - Microsoft Internet Explorer 



■I 




Figure 17-15 

Test realise avec un jeu d ' enregistrements : requete avec la clause WHERE nom LIKE 'D%' 



Dans ce troisieme exemple, nous desirons obtenir les horaires des cours pour debutants et interme- 
diaires (voir figure 17-16) : 

SELECT jour, horaire FROM cours WHERE niveau IN ( 'debutant' , 'intermedial' re' ) 
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Figure 17-16 

Test realise avec un jeu d 'enregistremenls : requete avec la clause WHERE niveau IN 
('debutant', 'intermediaire') 



Commande SELECT avec la clause ORDER BY 

Dans les differents exemples que nous vous avons proposes jusqu'a present, les enregistrements 
etaient retournes dans l'ordre de la saisie initiale (en general, l'ordre de la cle primaire ID auto- 
incrementee). Si vous souhaitez presenter les enregistrements dans un ordre different, utilisez la 
clause ORDER BY en precisant le ou les champs par rapport auquel le tri s'effectue. Avec ASC, vous 
triez par ordre croissant, avec DESC, par ordre decroissant. Par defaut, l'ordre est croissant. 
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Dans l'exemple suivant, nous desirons trier par ordre alphabetique les noms des adherents nes avant 
1982 (voir figure 17-17) : 

SELECT nom, prenom FROM adherents WHERE anneeNai ssance<1982 ORDER BY nom 
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Figure 17-17 

Test realise avec un jeu d'enregistrements : requete avec la clause ORDER BY nom 



Dans ce deuxieme exemple, nous desirons trier les enregistrements selon l'ordre croissant de Fiden- 
tifiant du cours cours ID (cle etrangere), puis selon l'ordre alphabetique du champ nom (voir 
figure 17-18). 



SELECT coursID, nom FROM adherents WHERE anneeNaissance<1982 ORDER BY coursID, nom 



Base de donnees MySQL 

Partie V 



J localhost / localhost / sport_dt> / adherents | phpMyAdmin 2.7.0-pl1 - Microsoft Internet Explorer 




Figure 17-18 

Test realise avec un jeu d'enregistrements : requite avec la clause ORDER BY coursID, nom 



Commande SELECT avec la clause LIMIT 

La clause LIMIT indique le nombre maximal d'enregistrements pour le resultat retourne. Elle est 
toujours placee a la fin de la requete. Si vous faites suivre cette clause d'un seul chiffre, la limite 
s' applique a partir de la premiere ligne ; si vous indiquez deux chiffres separes par une virgule, le 
premier indique le numero de ligne a partir de laquelle la limite precisee pai - le deuxieme chiffre 
s' applique. 



A noter 

Cette clause est specifique a MyQSL et ne fait pas partie du standard SQL. 
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Dans l'exemple ci-dessous, nous desirons obtenir une selection des adherents identique a celle de 
l'exercice precedent, mais limitee aux trois premiers enregistrements (voir figure 17-19) : 

| SELECT nom, prenom FROM adherents WHERE anneeNai ssance<1982 ORDER BY nom LIMIT 3 
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— requete SQL 




SELECT nom. prenom 




FROM adherents ' 




WHERE anneeNalssance «1 982 , 




ORDER BY nom J 




LIMIT 3 
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Figure 17-19 

Test realise avec un jeu d' enregistrements : requete avec la clause LIMIT 3 



Dans ce deuxieme exemple, nous desirons obtenir une selection des adherents identique a celle de 
l'exercice precedent, mais limitee aux trois premiers enregistrements situes apres la deuxieme ligne 
des resultats de la selection initiale (voir figure 17-20) : 

SELECT nom, prenom FROM adherents WHERE anneeNai ssance<1982 ORDER BY nom LIMIT 2,3 
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Figure 17-20 

Test realise avec un jeu d 'enregistrements : requete avec la clause LIMIT 2,3 



Commande SELECT avec jointure 

La jointure permet de creer des requetes poitant sur des donnees reparties dans plusieurs tables. Pour 
realiser une jointure, on utilise la meme syntaxe que pour une requete traditionnelle, mais en indi- 
quant dans la clause FROM la liste des tables concernees, separees par des virgules, et en ajoutant dans 
la clause WHERE l'expression de selection qui permet le rapprochement entre les tables. En general, 
l'expression de selection qui permet le rapprochement entre tables s'exprime par une egalite entre la 
cle primaire d'une table et la cle etrangere de l'autre (par exemple : entre ID de la table cours et cour- 
sID de la table adherents). II faut mentionner le nom de la table en prefixe des noms de champs pour 
eviter toute ambiguite, notamment entre deux champs portant le meme nom mais integres dans des 
tables differentes. Afin d'eviter de rappeler dans son integralite le nom de chaque table en prefixe des 
noms de champs, il est interessant de creer un alias (exemple : dans la clause FROM, si on declare 
adherents AS a, on peut utiliser l'appellation a. nom dans la clause WHERE). 
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Dans Fexemple ci-dessous, nous desirons obtenir les niveaux (issus de la table cours), mais aussi les 
noms des adherents correspondants (issus de la table adherents) (voir figure 17-21) : 

SELECT adherents. nom, adherents .prenom, cours. niveau FROM adherents, cours WHERE 
Scours. ID=adherents .coursID ORDER BY cours. niveau DESC 
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Test realise avec un jeu d ' enregistrements : requete avec jointure sur deux tables 



Dans ce deuxieme exemple, nous desirons obtenir la meme selection que dans Fexemple precedent, 
mais en utilisant des alias pour les deux tables concernees (voir figure 17-22) : 



SELECT a. nom, a. prenom, c. niveau FROM adherents AS a, cours AS c WHERE c. ID=a .coursID 
BORDER BY c. niveau DESC 
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— requete SQL 




SELECT a nom, a prenom. c niveau 




FROM adherents AS a cours AS c 1 




WHERE c 10 = 3 COursID J 




ORDER BY c niveau DESC y 




LIMIT 0 . 30 
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Figure 17-22 

Test realise avec un jeu d' enregistrements : requite avec jointure et alias de tables 



Dans ce troisieme exemple, nous desirons obtenir le meme jeu que dans l'exemple precedent avec en 
plus le nom du professeur qui assure l'enseignement du cours (voir figure 17-23). 

SELECT a. nom, a. prenom, c. niveau, p.nomProf FROM adherents AS a, cours AS c, professeurs 
*AS p WHERE c.ID=a.coursID AND p. ID=professeursID ORDER BY c. niveau DESC 
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Test realise avec un jeu d'enregistrements : requite avec jointure sur trois tables et alias 



Commande INSERT 

La commande INSERT permet d'inserer de nouveaux enregistrements dans la base et peut etre utilisee 
selon plusieurs variantes. Pour ajouter des valeurs dans une table a partir de variables ou de constan- 
tes recuperees par un script, par exemple, il existe deux methodes differentes : INTO VALUES et INTO 
SET. Nous verrons aussi comment utiliser la commande INSERT pour inserer des enregistrements a 
partii - d'une requete (INTO SELECT). Cette derniere methode est tres interessante pour realiser une 
copie d'enregistrements d'une table vers une autre. 

Lors de 1' insertion directe a partir de valeurs, les textes doivent etre encadres entre guillemets simples 
alors que les nombres peuvent s'en passer (exemple : ' Chapel i er ' ou 1980). 

A noter 

Dans les scripts PHP, il est egalement possible d'indiquer des expressions dans une requete (des variables, par 
exemple : '$var'). Dans ce cas, elles sont evaluees avant d'etre insereesdans la base. 
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Syntaxe de la commande 
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autre table. 




SELECT 




* | valeurl, valeur2 valeurN 




FROM tabl e_source 




[WHERE expression_de_selection] 


Legende 


table : table dans laquelle sont inserees les donnees. 




champN : nom du champ de la table dans lequel est inseree val eurN. 




valeurN : la valeur doit respecter le format standard de son type (exemple : 'bonjour' ou 4562 ou 




' 2003-03-24'). A noter : Si la requete est integree dans un script PHP, la valeur peut etre remplacee par 




une variable qui est evaluee au moment de I'insertion (exemple '. 1 $var ' ). 
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(il faut done choisir de saisir soit xxx, soit yyy). 




tabl e_source ! dans le cas du transfert d une table source vers une table cible, le symbole * peut etre 




utilise, mais il faut veiller a ce que le nombre de champs des deux tables soit identique. 


Exemples 


Exemple 1 : 




INSERT INTO adherents VALUESC7 ,2, ' Rastout ' , ' Stephane' , 1968) 




Exemple 2 : 




INSERT INTO adherents (ID,coursID,nom,prenom,anneeNaissance) 




VALUES (7, 2. 'Rastout' , 'Stephane' ,1968) 




Exemple 3 ! 




INSERT INTO adherents 




SET I D=7 , coursID=2, nom= ' Rastout ' , prenom= ' Stephane ' , anneeNaissance=1968 




Exemple 4 : 




(Attention ! uniquement si la requete est integree dans un script PHP) 




INSERT INTOagences 




SET ID='$varl', coursID='$var2' , nom='$var3' , prenom='$var4' , anneeNaissance=' $var5 ' 




Exemple 5 : transfert d'une table 




INSERT INTO adherents SELECT * FROM adherentsBIS 
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Commande INSERT a partir de valeurs : methode 1 

Dans sa premiere syntaxe, la commande INSERT permet d'enumerer partiellement les champs a inserer 
dans la base (voir l'exemple de la figure 17-26). Cela peut etre interessant dans le cas d'un premier 
enregistrement partiel, mais il faut alors s' assurer que les champs omis sont parametres pour etre 
facultatifs (attribut null=null) ou auto-incrementes. Dans le cas ou l'enumeration des champs n'est 
pas indiquee, il faut s' assurer que l'ordre des valeurs respecte celui des champs de la table (voir 
l'exemple de la figure 17-24). Sachez cependant que, meme si l'enumeration est facultative, il est 
fortement conseille de toujours specifier la liste des champs dans lesquels les valeurs doivent s'inserer. 
En effet, si la structure de la table change, votre requete risque de ne plus fonctionner. 

Dans l'exemple ci-dessous, nous desirons ajouter un adherent supplementaire a la table adherents. 
Dans la syntaxe employee, nous n'indiquons pas les differents champs de la table dans lesquels les 
valeurs vont etre enregistrees. II faut done imperativement que l'ordre des valeurs et leur nombre 
correspondent a ceux de la table adherents. Le premier champ ID etant la cle primaire (qui est auto- 
incrementee), il faut lui attribuer la valeur NULL pour ne pas entrer en conflit avec la valeur que 
MySQL lui attribue automatiquement (voir figure 17-24). 



INSERT INTO adherents VALUES (NULL, 2, 'Rastouf, 'Stephane' ,1968) 
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Figure 17-24 

Pour tester des commandes d' insertion, vous pouvez aussi utiliser le gestionnaire phpMyAdmin de Wamp 5 comme 
pour les requites SELECT que nous venons de presenter. 

Pour ajouter un nouvel adherent vous pouvez egalement utiliser la syntaxe complete de la commande 
INSERT. Dans ce cas, mentionnez uniquement les champs qui recoivent une valeur (coursID, nom, 
prenom et age). La cle ID n' etant mentionnee ni dans les champs ni dans les valeurs, MySQL lui attribue 
une valeur par incrementation du dernier ID saisi (voir figure 17-26). 

INSERT INTO adherents (coursID. nom, prenom, anneeNai ssance) VALUES (2, 
j ^-'Rastout' , 'Stephane' ,1968) 
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Figure 17-25 

Vous pouvez verifier le bonfanctiannement d'une insertion en ajfichant le contenu de la table concernee ( ici la table 
adherents). Vous constatez que le nouvel enregistrement a bien ete ajoute a la suite des precedents. 
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Figure 17-26 

Cette deuxieme requete d' insertion est equivalente a celle de la figure 17-24 et le resultat obtenu est identique a celui 
de la figure 17-25. 



Commandes SQL avancees 

Chapitre 17 



Commande INSERT a partir de valeurs : methode 2 

Dans la deuxieme syntaxe de INSERT, les couples champ/valeur doivent etre specifies et separes parun 
signe egal (champl='valeurl '). La clause utilisee n'est plus VALUES mais SET. 

Dans l'exemple qui suit, nous allons ajouter un nouvel adherent, comme dans les deux exemples 
precedents (voir figure 17-27) : 

INSERT INTO adherents SET coursID=2, nom='Rastout' , prenom='Stephane' , anneeNaissance=1968 
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Figure 17-27 

Cette troisieme requete d' insertion est equivalente a celle de la figure 1 7-24. Le resultat obtenu est identique a celui de 
la figure 17-25. 



Commande INSERT a partir d'une requete 

Avec ce type de syntaxe, il est possible d'inserer le resultat d'une requete dans une table. Dans ce cas, 
la clause VALUES est remplacee par la requete a inserer. Cette syntaxe est particulierement interessante 
pour copier des donnees d'une table a l'autre (voir l'exemple de la figure 17-29) ou encore pour reali- 
ser la projection d'une table : on preleve certains de ses champs pour creer une autre table de plus 
petite faille (voir l'exemple de la figure 17-31). 

Dans ce premier exemple, on desire transferer le contenu de la table adherents dans une table de sauve- 
garde adherentsbackup. II faut evidemment que le nombre et les types des champs soient rigoureuse- 
ment identiques dans les deux tables (pour creer une structure identique, utilisez le formulaire de copie 
d'une table disponible dans l'onglet Operations de phpMyAdmin, voir figure 17-28) : 

INSERT INTO adherentsbackup SELECT * FROM adherents 

Dans ce deuxieme exemple, on desire faire une projection de la table adherents dans une autre table tabl e- 
desnoms (voir figure 17-31). Cette table contient uniquement les noms des differents adherents dans un 
champ nom avec une cle primaire auto-incrementee I D et devra etre creee au prealable (voir figure 17-30) : 

INSERT INTO tabl edesnoms (nom) SELECT nom FROM adherents 
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Figure 17-28 

Avant de rialiser la sauvegarde d'une table a Vaide de la commande INSERT, ttfaut crier une structure de table 
identique a celle de la table d transferer. Pour cela, cliquez sur le nom de la table adherents dans la partie gauche de 
phpMyAdmin, saisissez le nom de la nouvelle table dans la zone Copier la table vers et cliquez sur le bouton Exicuter. 
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Figure 17-29 

Apres la creation de la structure de la table adherentsbackup, saisissez la requite INSERT dans la zone de requite du 
gestionnaire et cliquez sur Exicuter. II ne vous reste plus qua verifier que la copie des donnies s'est bien effectuie 
d'une table a V autre. 
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Figure 17-30 

Avant de realiser la projection, ilfaut commencer par crier la petite table tabledesnorns qui va accueillir les noms des 
adherents. Pour creer cette table, saisissez le nam de la nouvelle table dans la zone de creation d'une table, indiquez 2 
pour le nombre de champs, puis renseignez le formulaire comme le montre la figure ci-dessus. 



3 locdlttott / iocalhost / sporl_db / labledesm 
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Figure 17-31 

Apres avoir cree la structure de la table tabledesnorns, saisissez la requete INSERT dans la zone de requete du 
gestionnaire et cliquez sur Executer. II ne vous reste plus qua verifier si la projection s'est bien ejfectuee. 
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Figure 17-32 

Si vous affichez le contenu de la table tabledesnoms, vous constatez que tous les noms de la table adherents ont ete 
copies dans les champs nom de la table tabledesnoms. 



Commande DELETE 

La commande DELETE permet de supprimer un enregistrement d'une table. Cette operation est irre- 
versible et il vaut mieux prevoir l'amchage d'un message d'avertissement avant validation defini- 
tive de la requete. La commande DELETE doit etre accompagnee de la clause WHERE (sinon, vous 
supprimez tous les enregistrements de la table), suivie d'une expression de selection d' enregistre- 
ments a supprimer. Cette meme expression peut d'ailleurs etre utilisee au prealable dans une requete 
SELECT pour selectionner et amcher les enregistrements a supprimer avec la requete DELETE lors de 
l'etape suivante : 

SELECT * FROM adherents WHERE nom='Rastout' 
DELETE FROM adherents WHERE non='Rastouf 
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Tableau 17-12. Syntaxe de la commande DELETE et exemple d'utilisation 



Fonction 

Syntaxe de la 
commande de 
suppression 



Legende 



Exemple 



Suppression d'enregistrements 

DELETE FROM 
table 

[WHERE expression_de_selection] 
[LIMIT [debut.] nbjignes ] 

table : table oil se trouvent les enregistrements selectionnes. 
[xxx] : le code xxx est facultatif. 

(Attention ! les crochets [ et ] ne doivent surtout pas etre saisis dans le code) 
Exemple : 

DELETE FROM adherents WHERE nom='Rastout' 



Dans l'exemple ci-dessous, on desire supprimer l'enregistrement correspondant a l'adherent Rastout 
Stephane (voir figure 17-33) : 



DELETE FROM adherents WHERE nom='Rastout' AND prenom='Stephane' 
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Figure 17-33 

La commande DELETE permet de supprimer un enregistrement selectionne par 1' expression qui complete la clause 
WHERE. 
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Commande UPDATE 

La commande UPDATE permet de modifier la valeur de certains champs si F expression de selection est 
validee. L' affectation des valeurs est introduite par la clause SET, comme pour la commande INSERT. 



Tableau 17-13. Syntaxe de la commande UPDATE et exemple d'utilisation 



Fonction 


Mise a jour d'enregistrements 


Syntaxe de la 
commande 
de modification 


UPDATE 

table 

SET 

chapl=val eurl , champ2=valeur2 champN=val eurN 

[WHERE expressi on_de_sel ecti on] 
[LIMIT [debut,] nbjignes ] 


Legende 


table : table ou se trouvent les enregistrements selectionnes. 
[xxx] : le code xxx est facultatif. 

(Attention ! les crochets [ et ] ne doivent surtout pas etre saisis dans le code) 


Exemple 


Exemple : 

UPDATE adherents SET coursID=3 WHERE ID=4 



Dans Fexemple ci-dessous, nous desirons mettre a jour le numero de telephone du professeur Tavan 
(voir figure 17-34) : 

UPDATE professeurs SET tel = 1 0150505050 ' WHERE nomProf='Tavan' 
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Figure 17-34 

La commande UPDATE permet de mettre a jour un enregistrement selectionne par V expression qui complete la 
clause WHERE. 
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Figure 17-35 

5/ on consulte ensuite le contenu de la table professeurs, on constate que le numero de telephone du professeur Tavan 
a bien ete modifie. 



Commande REPLACE 

La commande REPLACE permet de remplacer un enregistrement existant et done de modifier les 
valeurs de ses differents champs. Cette commande est differente de la commande UPDATE car elle 
supprime d'abord F enregistrement selectionne pour ensuite le reinserer avec de nouvelles valeurs. 
C'est en quelque sorte une combinaison des commandes DELETE et INSERT. Comme INSERT, cette 
commande peut etre realisee selon trois variantes. Les deux premieres variantes permettent de 
remplacer les champs d'un enregistrement selon les informations transmises par des valeurs, alors 
que la troisieme permet d'exploiter une requete SQL pour foumir les nouvelles donnees. La clause 
WHERE selectionne le jeu d'enregistrements a utiliser pour ce faire. 
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Tableau 17-14. Syntaxe de la commande UPDATE et exemples d'utilisation 



Fonction 

Syntaxe de 
la commande 
de remplacement 
a partir de valeurs 
(premiere methode) 

Syntaxe 

de la commande 
de remplacement 
a partir de valeurs 
(deuxieme 
methode) 

Syntaxe 

de la commande 
de remplacement 
a partir d'une 
requete 



Legende 



Exemples 



champN=val eurN 



Remplacement d'enregistrements 

REPLACE INTO 
table 

[ (champl, champ2 champN) ] 

VALUES 

(valeurl, valeur2 valeurN) 

REPLACE INTO 
table 
SET 

chapl=val eurl , champ2=valeur2, ... 

REPLACE INTO 

table_cible 

SELECT 

* | valeurl, valeur2 valeurN 

FROM table_source 

[WHERE expression_de_selection] 

tabl e : table dans laquelle les donnees seront modifiees. 

champN : nom du champ de la table dans lequel sera inseree la val eurN. 

valeurN : la valeur doit respecter le format standard de son type (exemple : 'bonjour' ou 4562 ou 
' 2003-03-24'). A noter : Si la requete est integree dans un script PHP, la valeur peut etre remplacee 
par une variable qui sera alors evaluee au moment de I'insertion (exemple : ' $var '). 
xxx | yyy : le code I separedesgroupesalternatifs (ilfaudra done choisirdesaisir soit xxx, soit yyy). 
tabl e_source : lorsqu'un jeu d'enregistrements issu d'une table source est utilise pour mettre a jour 
les champs d'une table cible, le symbole * peut etre employe, mais il faut veiller a ce que le nombre de 
champs soit identique dans les deux tables. 

Exemple 1 : 

REPLACE INTO adherents VALUES(6 .3, ' Hamond' ,' Laurence' , 1985) 
Exemple 2 : 

REPLACE INTO adherents ( ID,coursID,nom,prenom,anneeNai ssance) 

VALUES(6, 3, 'Hamond' , 'Laurence' ,1985) 
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Interfagage Flash-PHP-MySQL 



Apres F interfagage Flash-PHP-Txt (voir chapitre 11), nous vous proposons de decouvrir Finterfacage 
Flash-PHP-MySQL. Toujours par F intermediate de scripts PHP, il permet d'ajouter ou d'actualiser 
des informations dans une base de donnees MySQL depuis une animation Flash ou encore de recuperer 
et de mettre en forme des informations issues de cette meme base. 

Ce chapitre sera decoupe en deux grandes parties. Dans la premiere, nous presenterons les techniques 
pour interfacer des scripts PHP avec une base MySQL. Dans la seconde, nous mettrons en application 
ces techniques pour realiser des interfacages Flash-MySQL. 

Interfagage PHP-MySql 

Dans les chapitres precedents, nous avons manipule les informations de la base de donnees MySQL 
par Fintermediaire du gestionnaire phpMy Admin. Cependant, malgre son interface de gestion assez 
simple, cet outil est plutot reserve aux developpeurs. 

Afin que les utilisateurs puissent interagir sur la base, il leur faut developper des interfaces de gestion 
de donnees sur mesure et securisees a Faide de fonctions PHP dediees a MySQL et de requetes SQL. 

Ces interfaces sont en general materialisees par des scripts PHP auxquels on envoie des variables 
depuis un simple formulaire ou une animation Flash. La premiere fonction de ces scripts est d'etablir 
une liaison avec la base de donnees (la « connexion »), puis d'elaborer une requete SQL a partir des 
variables recues et de transmettre cette requete a la base de donnees. Apres reception de cette requete, 
la base de donnees recherche et met en forme les informations demandees et les retourne aux scripts 
emetteurs. La seconde fonction des scripts est d' informer l'utilisateur des resultats en les affichant a 
l'ecran ou en les retournant a F animation Flash qui est a Forigine de la demande. 
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Concept de la connexion a la base 

Pour creer une interface de gestion de donnees, il faut configurer une connexion a la base de donnees 
arm que les scripts PHP soient authentifies comme ay ant un droit d'acces aux donnees de la base 
ciblee. 

Pour que vous compreniez bien le concept de la connexion a la base, nous allons comparer cette 
connexion a Fouverture d'un « canal » entre la base et les scripts dynamiques du site (voir figure 18-1). 
Ce canal permet d'acceder aux differents champs qui constituent les tables de la base a Faide de 
requetes SQL puis de recuperer une selection d'enregistrements. 
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Figure 18-1 

Schema de principe d'une connexion a la base de donnees : la connexion peut etre comparee a un « canal » 
autorisant le dialogue entre le serveur Web et le serveur MySQL. 
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Creation d'un fichier de connexion 



Alternative au fichier de connexion 

La creation d'un fichier de connexion a la base de donnees est interessante des que plusieurs scripts d'un meme 
site doivent s'y connecter. Les parametres de configuration au serveur MySQL sont ainsi regroupes dans un meme 
fichier, ce qui facilite leur modification lors du transfert du site sur un serveur different. Neanmoins, si votre applica- 
tion dynamique est la seule a necessiter un acces a la base de donnees, vous pouvez aussi inserer les parametres 
et instructions de connexion directement dans le code de I'application en utilisant le script ci-dessous (vous trouve- 
rez un exemple illustrant cette technique dans le fichier signetsXml .php de I'application des signets dynamiques 
du chapitre 22). 

// Configuration isolee de la connexion MySQL 

mysql_connect(localhost, sport, eyrolles); 
mysql_select_db(sport_db) ; 



La connexion a la base utilise des fonctions dediees a la gestion de MySQL (en general, ces fonctions 
commencent par le prefixe mysql_, par exemple mysql_connect ou mysql_sel ect_db). Les parametres 
necessaires a la connexion (identifiant, mot de passe, etc.) sont souvent regroupes dans un fichier 
externe arm de faciliter sa maintenance en cas de modification. Ce fichier de connexion peut etre 
realise en mode code dans un simple editeur ou en mode assiste a Faide d'une boite de dialogue de 
1' interface de Dreamweaver. La deuxieme solution permet de disposer d'un fichier de connexion 
compatible avec la creation de pages dynamiques generees par des comportements serveur de 
Dreamweaver. Vous pourrez ainsi utiliser le meme fichier de connexion pour vos applications Flash 
et pour les pages dynamiques du site. 

Afin que vous puissiez choisir la solution qui vous convient le mieux, nous detaillerons ces deux 
solutions ci-dessous. 

Dans le chapitre 16 dedie au gestionnaire de base de donnees phpMy Admin, nous avons cree un 
compte utilisateur sport dans la table user de la base mysql . Nous reprendrons ces merries parametres 
ci-dessous afin d'etre reconnu par le serveur MySQL comme un utilisateur de la base sport_db. 
Si vous ne desirez pas creer d' utilisateur, vous pouvez utiliser en local l'utilisateur root, configure par 
defaut lors de l'installation de la base MySQL. Dans ce cas, il vous suffit d'indiquer root comme 
login et de ne pas preciser de mot de passe (Attention ! pour des raisons de securite evidentes, cette 
configuration est strictement reservee a un usage local). 

Creation d'un nouveau site dans Dreamweaver 

Avant de creer le fichier de connexion a la base, il faut configurer un nouveau site correspondant au 
projet Sport (revoir si besoin la demarche, presentee dans le chapitre 4). Letape 5 de la procedure 
decrite ci-dessous, dediee a la configuration d'un serveur devaluation, permettra par la suite de creer 
automatiquement le fichier de connexion a la base de donnees. Si vous desirez configurer vous-meme 
ce fichier en mode code, validez votre nouveau site a partir de l'etape 4 : 

1. Depuis le menu de 1' interface de Dreamweaver, cliquez sur la rubrique Sites puis selectionnez 
Gerer les sites. 

2. Dans la boite de dialogue Gerer les sites, cliquez sur le bouton Nouveau. 

3. Dans la boite de dialogue Definition du site, cliquez sur l'onglet Avance s'il n'est pas deja selectionne. 
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4. Cliquez sur la categorie Infos Locales (voir figure 18-2) et renseignez les champs suivants : 

- Nom du site : SITEsport ; 

- Dossier racine : cliquez sur le petit dossier situe a droite du champ afin d'ouvrir l'explorateur 
de fichier. Creez puis selectionnez un nouveau dossier /SITEsport/ dans le repertoire racine 
www de la suite Wamp 5. 

5. Cliquez ensuite sur la categorie Serveur d' evaluation (voir repere 1 de la figure 18-3) et rensei- 
gnez les champs suivants (si vous ne desirez pas utiliser le mode assiste de Dreamweaver pour 
creer votre fichier de connexion, cette etape 5 n'est pas necessaire) : 

- Modele de serveur : selectionnez PHP-MySQL dans le menu deroulant (voir repere 2 de la 
figure 18-3) ; 

- Acces : selectionnez Local/Reseau dans le menu deroulant (voir repere 3 de la figure 18-3) ; 

- Dossier du serveur d' evaluation : theoriquement, ce champ doit etre preconfigure avec le 
chemin menant au repertoire du site www/SITEsport (voir repere 4 de la figure 18-3) ; 

- Prefixe de FURL: ajoutez SITEsport/ a la suite de http://local host/ (voir repere de la 5 
figure 18-3). 

6. Cliquez sur le bouton OK de la boite de dialogue puis sur le bouton Terminer de la boite Gerer 
les sites. 
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Figure 18-2 

Configuration de la categorie Infos locales d'un nouveau site destine a tester V application dynamique Sport 
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Figure 18-3 

Configuration de la categorie Serveur d 'evaluation. La configuration de cette categorie est necessaire si Von desire 
creer un fichier de connexion conforme aux comportements ser\>eur de Dreamweaver. 



Creation avec la boite de dialogue de Dreamweaver 

Voici la procedure a suivre pour creer un flchier de connexion a la base MySQL a l'aide de l'assistant 
de Dreamweaver. Avant de commencer, assurez-vous que Wamp 5 est demarre. 

1 . Ouvrez une page PHP dans Dreamweaver (menu Fichier>Nouveau, selectionnez Page dynamique 
et PHP puis cliquez sur Creer) (voir figure 18-4). 

2. Deroulez le panneau Application et selectionnez Fonglet Base de donnees (voir figure 18-5). 

3. Cliquez sur le bouton + et selectionnez la rubrique Connexion MySQL qui s'affiche dans le menu 
contextuel (voir figure 18-5). 
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4. La boite de dialogue Connexion MySQL s'affiche (voir figure 18-5). 

5. Saisissez un nom pour la connexion que vous allez creer. Ce nom doit etre explicite et ne doit 
pas comporter d'espace. Dans le cadre de notre application, nous utiliserons ConnexionSport. 

6. Dans le champ Serveur MySQL, indiquez Fordinateur sur lequel est installe le serveur MySQL. 
Cela peut etre une adresse IP ou un nom de serveur ; dans notre cas, le serveur MySQL etant 
installe sur le meme serveur que PHP, nous saisissons localhost. 

7. Saisissez ensuite les parametres de l'utilisateur sport : nom de l'utilisateur = sport et mot de 
passe = eyrol 1 es. Si vous n'avez pas defini l'utilisateur sport dans la base MySQL, vous pouvez 
saisir provisoirement l'utilisateur installe par defaut sur la base MySQL : nom de l'utilisateur = root, 
sans mot de passe. 
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Figure 18-5 

Depuis le panneau Base de donnees, cliquez sur + et selectionnez Connexion MySQL pour ouvrir la fenetre 
de parametrage de la connexion a la base. Saisissez les parametres du compte utilisateur Sport dans la boite 
de dialogue puis cliquez sur le bouton Selectionner pour afjicher la liste des bases disponibles sur le serveur 
MySQL. 



8. Cliquez sur le bouton Selectionner pour afficher toutes les bases de donnees disponibles (voir 
figure 18-5). Selectionnez la base sport_db et validez en cliquant sur le bouton OK. 

9. La base selectionnee s'affiche dans le champ Base de donnees. Verifiez que la connexion est 
valide en cliquant sur le bouton Tester. Un message vous informe que la connexion est etablie 
si tous vos parametres sont corrects (voir figure 18-6). Si la connexion echoue, verifiez de 
nouveau les parametres ci-dessus (Serveur, Nom, Mot de passe) et assurez-vous que Wamp 5 
est actif. 
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Figure 18-6 

Avant de valider votre connexion, vous pouvez tester si tous les parametres sont corrects en cliquant sur \e bouton 
Tester. 



10. Fermez la fenetre du message et confimiez la creation de la connexion en cliquant sur le bouton 
OK. 

1 1. La connexion a la base de donnees est desormais etablie. Une icone representant la base sport_db 
apparait dans la fenetre Base de donnees. Vous pouvez cliquer successivement sur les + qui prece- 
dent les noms des branches de Farborescence (ConnexionSport, puis Table, puis adherents, par 
exemple) pour deplier l'arbre de la base de donnees et faire apparaitre les differents champs qui 
constituent chacune de ses tables (voir figure 18-7). 
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Figure 18-7 

Unefois la connexion etablie, vous pouvez consulter tous les champs disponibles dans chacune des tables de la base 
de donnees sport_db. 



Attention ! Le repertoire Connections ne doit pas etre supprime ! 

Apres la creation d'une connexion, un sous-repertoire est automatiquement cree dans I'arborescence du site (C: 
wamp/www/SITEsport/). II se nomme Connecti ons et contient un fichier PHP qui porte le nom de la connexion 
qui vient d'etre configuree (voir figure 18-8). Ce fichier regroupe tous les parametres de votre connexion (nom du 
serveur MySQL, login du compte, mot de passe, nom de la base de donnees) et doit etre transfere sur le serveur 
distant lors de la publication du site. Evidemment, ce repertoire et ce fichier ne doivent en aucun cas etre supprimes, 
au risque d'interrompre toutes les interactions entre la base de donnees et les scripts dynamiques du serveur. 



12. Lors de la creation d'une connexion, un repertoire /Connections/ et un fichier connexionSport.php 
sont crees automatiquement. Si vous ouvrez le fichier connexi onSport . php dans l'editeur de code de 
Dreamweaver, vous remarquez qu'il contient tous les parametres de la connexion qui vient d'etre 
creee (voir figure 18-8). Pour ouvrir connexionScore.php, double-cliquez sur le nom du fichier 
dans le panneau Fichier, puis cliquez sur le bouton Afficher en mode code si necessaire. 
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Figure 18-8 

Lors de la creation d'une connexion, un repertoire Connections et un fichier portant le nom de la connexion 
ConnexionSport.php sont automatiquement crees dans I'arborescence du site. 



Creation en mode code a I'aide de I'editeur 

L' autre solution pour disposer d'un fichier de connexion consiste a saisir les parametres de connexion 
et les fonctions en mode Code dans I'editeur de votre choix. Afin que les scripts de cet ouvrage puissent 
etre exploites de la meme maniere quel que soit le mode de creation choisi, nous utiliserons la meme 
convention de nommage des variables que celle utilisee dans le fichier connexionScore.php genere 
automatiquement par Dreamweaver dans le mode de creation precedent (voir le code ci-dessous) : 

<?php 

# FileName="Connection_php_mysql .htm" 

# Type="MYSQL" 

# HTTP="true" 

$hostname_connexionSport = "localhost"; 
$database_connexionSport = "sport_db"; 
$username_connexionSport = "sport"; 
$password_connexionSport = "eyrolles"; 

SconnexionSport = mysql_pconnect($hostname_connexionSport, $username_connexionSport, 

*»$password_connexionSport) or trigger_error(mysql_error( ) , E_USER_ERROR) ; 

?> 
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Pour creer votre fichier de connexion en mode code, saisissez les instructions ci-dessus dans 
votre editeur et enregistrez-les dans un fichier PHP nomme connexionSport.php dans un reper- 
toire /Connections/. 



Descriptif du fichier de connexion 

Les trois premieres lignes sont des commentaires (leur saisie n'est done pas indispensable). 

Les quatre lignes suivantes correspondent a 1' initialisation des variables de connexion. Ainsi, le nom 
de la machine hote (hostname) est affecte par la valeur 1 ocal host car le serveur MySQL se trouve sur 
la meme machine que le serveur Web ; le nom de la base (database) est affecte par sport_db, qui est 
le nom de la base a laquelle vous desirez vous connecter ; le nom d'utilisateur et le mot de passe 
(username et password) permettent d'etre authentifie par la base comme un utilisateur valide (pour ces 
deux derniers parametres, vous pouvez utiliser les valeurs sport et eyrolles ou root sans mot de 
passe si Futilisateur sport n'a pas ete cree). 

La ligne qui suit ces initialisations exploite la fonction mysql_pconnect( ) et reprend en parametres 
trois des variables de connexion precedentes. Cette fonction envoie une demande de connexion au 
serveur MySQL. Celui-ci, apres avoir verifie que Futilisateur et son mot de passe sont valides, 
retourne un identifiant de connexion memorise dans la variable SconnexionSport. Si une des informa- 
tions est invalide, la fonction retourne la valeur FALSE et un message d'erreur (tri gger_error( )) indique 
que la connexion a echoue. 



A noter 

Si vous desirez gerer vous-meme les problemes de connexion (en faisant un simple test sur I'identificateur 
retourne par la fonction, par exemple), ajoutez le caractere @ devant la fonction afin d'eviter qu'elle ne genere auto- 
matiquement un message d'erreur a I'ecran (exemple : @mysql_connect( )). 



II existe deux declinaisons de cette fonction PHP de connexion a un serveur MySQL : 

• mysql_connect( ) : connexion ephemere au serveur. Cette connexion se termine par l'appel de la 
fonction mysql_cl ose( ) ou a la fin du script ; 

• mysql_pconnect( ) : connexion persistante au serveur. Contrairement a la connexion ephemere, 
elle ne se termine pas par l'appel de la fonction mysql_close() ou a la fin du script mais est 
conservee pour un prochain acces, d'ou son nom. Ce type de connexion est interessant pour des 
applications tres sollicitees (les moteurs de recherche, par exemple). Cependant, MySQL ayant un 
processus d'etablissement de connexions relativement efficace, en regie generate, il est souvent 
preferable d'utiliser des connexions ephemeres. 



Attention aux connexions persistantes ! 

Si vous utilisez la fonction de connexion persistante mysql_pconnect( ) (et non mysql_connect( )) et que la 
configuration du serveur Web Apache ou de MySQL n'est pas adaptee, vous risquez d'atteindre rapidement le 
nombre maximal de connexions et de bloquer votre serveur MySQL (apparition du message «Too Many 
Connections »). Dans ce cas, si vous ne pouvez pas modifier la configuration de vos serveurs, remplacez votre 
fonction de connexion persistante par une fonction de connexion ephemere (mysql_connect( )). 



P M Base de donnees MySQL 

Concept du jeu d'enregistrements 

Une fois que le « canal » d'acces au serveur MySQL est mis en place, vous pouvez exploiter les enre- 
gistrements de la base et extraire un sous-ensemble de donnees d'une ou plusieurs tables. Ce sous- 
ensemble de donnees s'appelle un jeu d'enregistrements et forme une nouvelle table puisqu'il est 
forme de champs et d'enregistrements selon la requete d' extraction employee. 

Pour creer un jeu d'enregistrements, vous allez devoir elaborer une requete SQL caracterisee par les 
criteres de selection des enregistrements et par les champs demandes (revoir si besoin le chapitre 17 
consacre aux commandes SQL). 

Nous rappelons que pour transmettre une requete SQL a la base de donnees, il est indispensable qu'une 
connexion soit prealablement etablie avec le serveur MySQL. En effet, la requete et le jeu d'enregis- 
trements emprunteront le « canal » de la connexion connexionSport. Les differentes informations qui 
constituent une requete permettent de selectionner la table (ou les tables) de la base a laquelle la connexion 
donne acces et de definir les criteres de selection des enregistrements et les noms des champs qu'on 
desire exploiter dans la page dynamique du site (voir le repere 1 de la figure 18-9). En reponse, le 
serveur MySQL renvoie un jeu d'enregistrements (voir le repere 2 de la figure 18-9). Ces enregistrements 
sont ensuite utilises comme elements dynamiques dans la page PHP qui a genere la requete. 



Ordinateur de developpement (localhost) 




Figure 18-9 



Schema de principe d'une requete et d'un jeu d'enregistrements : la requete SQL et le jeu d'enregistrements utilisent 
le « canal » de la connexion a la base de donnees pour passer du serveur Web au serveur MySQL et vice versa. 
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Creation d'un jeu d'enregistrements 
Bibliotheque de fonctions MySQL 

Nous disposons maintenant d'un fichier (dans notre exemple, le fichier connexionScore.php) regrou- 
pant les parametres de connexion ainsi que la fonction de connexion (mysql_connect( ), qui retoume 
l'identificateur de connexion nomme SconnexionSport dans notre exemple). 

Nous pouvons desormais construire une premiere page dynamique qui affichera les informations 
issues de la base de donnees. Nous allons envoyer une requete SQL a la base de donnees afin de recu- 
perer les differents niveaux de la table cours. Pour cela, nous avons besoin d'autres fonctions PHP 
dediees a la gestion de MySQL (revoir le tableau 6-18 ou voir le tableau recapitulatif 18-1). Ces 
fonctions PHP-MySQL sont regroupees dans une bibliotheque (ou extension) et permettent, entre 
autres, de se connecter au serveur MySQL, d'executer des requetes SQL ou encore de recuperer les 
resultats en les mettant en forme pour les afficher dans la page dynamique. 
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Figure 18-10 

L'onglet Reference du panneau Resultats de Dreamweaver permet d'acceder a la syntaxe et a la description de 
chacune des fonctions PHP dediees d MySQL.. 
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A noter 

Ces fonctions sont facilement identifiables car leur nom commence toujours par le prefixe mysql_. Vous pouvez 
d'ailleurs consulter la liste exhaustive de ces fonctions MySQL depuis Dreamweaver a partir du panneau Resultats, 
onglet Reference (selectionnez ensuite dans les menus deroulants Livre : Reference PHP de poche : puis Fonc- 
tions MySQL ; voir figure 18-10). Notez que ce meme onglet Reference permet aussi d'acceder aux differentes 
commandes SQL, presentees au chapitre 17 de cet ouvrage (voir figure 18-11). 
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Figure 18-11 

L' onglet Reference du panneau Resultats de Dreamweaver permet aussi d'acceder a la syntaxe des commandes SQL 
de MySQL. 
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Tableau 18-1. Tableau recapitulatif des principales fonctions PHP dediees a MySQL 



Fonction PHP 


Description 


mysql 
mysql 


_connect( ) 
_pconnect( ) 


Permet d'etablir une connexion (ou encore un « canal » ; revoir figure 18-1) avec le serveur 
MySQL selon les parametres de I'utilisateur (nom et mot de passe) et d'un serveur specifique 
(exemple : monserveur.com ou localhost si le serveur MySQL est installe sur la meme machine 
que le serveur Web). 

Cette fonction renvoie un identificateur qui est ensuite utilise pour dialoguer avec le serveur. Cet 
identificateur peut etre memorise dans une variable (par exemple : Sconnexion) afin de faciliter 
son integration dans les autres fonctions PHP de la bibliotheque MySQL (mysql_select_db( ) 

nil iru/cnl m\ar\i I ^ nar ovo mnlo\ Qi la pnnnovinn Q\/or* lo con/oi ir IWIwQOI act imnnccihlo I'iHon- 
UU 1 1 1 jr o 1 ljUc I y \ J [Ja.1 cacI 1 Ifjlc/ . Ol id UUI 11 IcaIUi 1 dvcU Iti otil vtJUl Ivly OUL col II 1 IfJUool UlC, 1 lUtil 1 

tificateur renvoye est egal a 0 et un message d'erreur s'affiche a I'ecran. Le fait que la valeur 
retournee en cas d'echec soit nulle permet de s'assurer facilement que la connexion est bien eta- 
blie a I'aide d'un simple test : if ( Uconnexi on) {//suite des fonctions). 
A noter : Une declinaison de cette fonction (mysql_pconnect( ) ) permet d'obtenir une connexion 
persistante a la base. 


mysql 


_sel ect_db( ) 


Permet de selectionner une base de donnees du serveur MySQL pour une connexion specifique. 
Par exemple, la fonction mysql_select_db("sport_db" , $connexion) permet de preselec- 
tionner la base sport_db pour toutes les requetes utilisant I'identifiant de connexion $connexion. 


mysql 


_query( ) 


Permet d'executer une requete SQL (SELECT) mais aussi tout autre type de commande MySQL 
(INSERT, UPDATE, etc.). 

Cette fonction renvoie un pointeur qui permet d'exploiter les resultats de la requete (appele aussi 
« jeu d'enregistrements » ou « RecorSet » : rs). 

En general, la valeur de ce pointeur est affectee a une variable du script (par exemple : 
$ rs=inysql _query ( $query,$connexion)). 

A noter :Ce pointeur ne peut pas etre directement utilise ; ilfautdoncfaireappel a une autre fonc- 
tion (par exemple myql_fetch_row( ) ou myql_f etch_asso( ) ) pour recuperer les differentes 
lignes du resultat. 


mysql 


_fetch_row( ) 


Permet de recuperer une des lignes du jeu d'enregistrements et positionne le pointeur initial sur la 
ligne suivante. Avec cette fonction, chaque ligne de resultat est renvoyee sous forme d'un tableau 
indice. En general, une variable de type tableau est alors affectee par le resultat retourne afin de 
pouvoir facilement ['exploiter au sein du script. Par exemple, si $row=mysql_fetch_row($rs), 
on peut ensuite afficher la valeur de premier champ avec I'instruction suivante : echo $row[0] ; 


mysql 


_fetch_asso( ) 


Permet de recuperer une des lignes du jeu d'enregistrements et positionne le pointeur initial sur 
la ligne suivante. Avec cette fonction, chaque ligne de resultat est renvoyee sous forme d'un 
tableau associatif. En general, une variable de type tableau est alors affectee par le resultat 
retourne afin de pouvoir facilement I'exploiter au sein du script. Par exemple, si 
$row=mysql_fetch_row($rs), on peut ensuite afficher la valeur du champ nom avec I'instruction 
suivante : echo $row['nom']; 


mysql 


_fetch_array( ) 


Permet de recuperer une des lignes du jeu d'enregistrements et positionne le pointeur initial sur 
la ligne suivante. Avec cette fonction, chaque ligne de resultat peut etre renvoyee sous forme 
d'un tableau indice, d'un tableau associatif ou d'un tableau mixte selon un argument optionnel 
de la fonction 


mysql 


_fetch_object( ) 


Permet de recuperer une des lignes du jeu d'enregistrements et positionne le pointeur initial sur la 
ligne suivante. Avec cette fonction, chaque ligne de resultat peut etre renvoyee sous forme d'un objet. 
Par exemple, si $row=mysql_fetch_objetct($rs ), on peut ensuite afficher la valeur du champ 
nom avec I'instruction suivante : echo $row->nom; 


mysql 


_f ree_result( ) 


Permet de liberer la memoire utilisee par un jeu d'enregistrements. Cette fonction est particulie- 
rement recommandee lorsque des jeux d'enregistrements risquent de solliciter beaucoup de 
memoire au sein d'un meme script. A noter : Si cette fonction n'est pas utilisee, la memoire allouee 
aux jeux d'enregistrements sera automatiquement videe a la fin du script. 
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Partie V 

Procedure de creation d'un jeu d'enregistrements 

Pour creer un jeu d'enregistrements dans une nouvelle page dynamique, il faut commencer par etablir 
une connexion avec le serveur MySQL. Pour cela, il suffit d'appeler (a l'aide de la fonction 
requi re_once( )) le fichier de connexion. 

Inclusio n du fichier connexion. php 



Shostname = "localhost"; 



Sdatabase = "sportdb"; — , 
Susername = "sport"; 
Spassword = "eyrolles"; 



(T) Declarations des Variables de connexion 



Sconnexion = mysql_conn< ct( Shostname, Susername, Spassword ); (2) sefVBUf ^jyg^/ 



mysql_select_db( Sdatabase, Sconnexion ); (3) Selection de la base de donnees 

$query_rs = " SELECT niveau FROM cours "; (4^ Enregistrement de la requete SQL 

(en gras) dans une variable $query_rs 



1 

Srs = mysql_query( $query_rs, Sconnexion ); (5J Soumission de la requete a la base 

© 



1 



Srow rs = mysql_fetch_assoc( Srs ); 



1 



echo $row_rs['niveau'] 



Transformation des elements 
du resultat en tableau 



(7) Utilisation d'un element du resultat 



Figure 18-12 

Detail d'un script d'envoi d'une requete SQL et de la mise en forme du jeu d'enregistrements correspondant 

Lors de l'execution de la page, tout le contenu du fichier est copie dans votre page dynamique a la 
place de l'instruction requi re_once( ) (voir reperes 1 et 2 de la figure 18-12). Vous pourrez ensuite 
fake reference aux variables Sdatabase et Sconnexion dans les differentes fonctions de la page (voir 
reperes 3 et 5 de la figure 18-12). 

Une fois la connexion etablie avec le serveur MySQL, selectionnez la base de donnees sur laquelle 
vous desirez intervenir a l'aide de la fonction mysql_select_db() (voir repere 3 de la figure 18-12). 
Le nom de la base a selectionner et la connexion concernee sont transmis dans les arguments de la 
fonction. 
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Chapitre 18 



L'etape suivante consiste a elaborer la requete SQL qui sera transmise a la base precedemment selec- 
tionnee. Pour cela, vous pouvez enregistrer cette requete dans une variable specifique nommee 
$query_rs (voir repere 4 de la figure 18-12). Cette variable est ensuite transmise en argument dans la 
fonction de soumission mysql_query( ) (voir repere 5 de la figure 18-12). L' autre argument de la fonc- 
tion permet de preciser que la requete doit etre transmise a la base de donnee par F intermediate de la 
connexion prealablement etablie (soit $connexion dans notre exemple). En reponse a la requete, la 
fonction retourne un pointeur qui est enregistre dans la variable $rs (rs pour RecordSet : jeu d'enre- 
gistrements). 

Le pointeur $rs ne peut pas etre exploite directement. II faut pour ce faire utiliser une fonction de 
mise en forme du jeu d'enregistrements (voir repere 6 de la figure 18-12). Selon les besoins de 
l'application, plusieurs types de fonctions peuvent etre retenues pour effectuer cette transformation : 
(mysql_fetch_row( ), mysql_fetch_asso( ), mysql_fetch_array ( ) ou encore mysql_fetch_objet( )). A 
chaque appel de ces fonctions, une ligne du jeu d'enregistrements devient accessible sous forme d'un 
tableau de variables (voir repere 7 de la figure 18-12) et le pointeur se deplace automatiquement sur 
la ligne suivante. Lorsque le jeu d'enregistrements est complement parcouru, le pointeur retourne une 
valeur FALSE. Cela permet d'integrer facilement la gestion de ces fonctions dans une structure de 
boucle (while ou for). 

Exemple de creation d'un jeu d'enregistrements 

Vous allez maintenant passer a la pratique et creer le script d'une page dynamique : 

1 . Dans Dreamweaver, ouvrez un nouveau document PHP (menu Fichier>Nouveau>Page dynami- 
que>PHP). Enregistrez-le sous le nom requetel.php dans le repertoire /sport (repertoire a creer 
si necessaire). II est preferable d'enregistrer le fichier tout de suite afin de pouvoir determiner 
sans ambiguite le chemin relatif d'acces au fichier connexi onSport . php que nous allons creer dans 
l'etape suivante. 

2. Afin de disposer des parametres du fichier de connexion precedemment cree, vous allez ajouter 
une commande requi re_once( ) au debut du fichier (voir repere 1 de la figure 18-13). N'oubliez 
pas de saisir au prealable la balise d'ouverture de script PHP : <?php. Lors de 1' interpretation du 
script par le module PHP, cette ligne sera automatiquement remplacee par le contenu du fichier 
connexi onSport. php (revoir figure 18-12). 

| requi re_once( ' . ./Connections/connexionSport.php' ) ; 

3. A la ligne suivante, ajoutez la fonction mysql_sel ect_db( ) en precisant en argument les variables 
$database_connexi onSport et $connexi onSport afin de selectionner la base sport_db pour les 
prochaines utilisations de la connexion precedemment creee ($connexi onSport). 

( mysql_select_db($database_connexi onSport, SconnexionSport) ; 

4. Saisissez ensuite la requete SQL SELECT niveau FROM cours et enregistrez-la dans une variable 
$query_rsRappel Niveaux. 

$query_rsRappel Niveaux = "SELECT niveau FROM cours"; 
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► CSS 

▼ Application 




B^es de donnees 
® 0 Type de document :PHP 



Liaisons Comport em Composant s 




|requite_once( ' . . /Conncccions/connexlonSpoccphp 1 )i 

Lvperaet de disposer de la variable (databaseconnexionSpott ec 
//de 1 ' ldentif icateuc de connexion "tconnexionSpott" ctee dans le CichleE externe 



ysql_select_db ($dacabase_connexionSpott ( t connexionSport) ; 
jSqueEy_E3BappelNlveaux ■ "SELECT niveau FROH coues"; 



Sdatabase_connexionSpoEt 



EsRappelHiveaux - ■ysql_queEy($query_EsRappelli'iveaux, fconnexionSpoEt) oe die (>ysql_eE 

JO); 

|//souftission de la requete et recuperation du po intent du ]eu d'encegiatceaenu 

la variable f tsRappellliveaux 
|(Lov_E3RappelNiveaux - fcysql_Cetch_afl30C((t3RappelNlveaux) ; 

scoraation de la pteaiere ligr.e du )eu d'entegistteaents dans un tableau associat 



H <htal><heed><aeta http-equiv«" Content -Type" content""text/ht*l; chatset»l30-8859-l"> 
<title>Requete K/titlex/head><body>PAGE DE LA REQUETE Kbr> 



p um ib i'lmiuiml niveau u e la latip i ' uhe s : 

i.hi. 2 

cho (cow_£3RappelHiveauxt 'niveau' ]; 

/aftiche la valeut du champ no* de la premiere licjne du ]eu d'erueqistreaents 



I </bodyx/ht»l> 





3 


■ysql_f r e e_cesu 1 1 ( ( tsRappe 1 Hi veaux } ; 

ba> 





'. \j connexxjnSport 



► Irtspecteur de bafcses 



Acbfs Fragments de code 



3CO/ 1 5 



Q SIIEsport v afflchage kxal 



BQ SB- SITCsport (C:\wafnp\wwwVSITEspoil) 
- CJ Connections 

•rf corwiexionSpott.php 
B £3 >Pofl_ 



requetel.php 



> 



► Rfadtets 



Activite de fichiefs cofnpKte. 



.lcj-n.il... I 



Figure 18-13 

Script de la page dynamique requetel.php 



5. Configurez la fonction de soumission de la requete en indiquant en argument le nom de la varia- 
ble precedemment creee (contenant la requete SQL) et le nom de la variable de Fidentincateur de 
la connexion (IconnexionSport). Vous pouvez completer cette instruction par une fonction qui 
affichera le detail de l'erreur si la soumission est impossible (or die(mysql_error( )). 

$rsRappelNiveaux = mysql_query($query_rsRappelNiveaux, SconnexionSport) 

6. Utilisez une fonction de transformation (voir le detail des differentes fonctions dans le 
tableau 18-1) de la ligne courante du jeu d'enregistrements afin de pouvoir exploiter les valeurs 
des resultats a l'aide d'un tableau de variables. 

| $row_rsRappelNiveaux = mysql_fetch_assoc($rsRappel Niveaux) ; 

7. Utilisez la syntaxe du tableau de variables adaptee a la fonction utilisee precedemment pour affi- 
cher la valeur d'un champ specifique du jeu d'enregistrements (voir repere 2 de la figure 18-13). 

| echo $row_rsRappelNiveaux[ 'niveau']; 
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8. A la fin de la page dynamique, utilisez la fonction mysql_f ree_resul t( ) afin de liberer la memoire 
utilisee par le jeu d'enregistrements. 

| mysql_free_resul t($rsRappel Niveaux) ; 

9. Enregistrez votre fichier. Pour tester le fonctionnement de la page dynamique, vous pouvez utili- 
ser la fonction Live Data de Dreamweaver ou consulter votre page dans le Web local de Wamp 5. 
Pour utiliser le mode Live Data de Dreamweaver, passez en mode creation (voir repere 1 de la 
figure 18-14), puis cliquez sur le bouton Live Data situe a droite des trois boutons de selection de 
mode (voir repere 2 de la figure 18-14). La valeur du premier niveau enregistre dans la base cours 
(soit debutant) doit alors s'afficher dans l'editeur (voir repere 3 de la figure 18-14). 
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Acbvte de fictiws complete. 



Figure 18-14 

Teif tie /a page dynamique requetel.php a I'aide de la fonction Live Data de Dreamweaver 



A noter 

Le mode Live Data ne peut fonctionner que si vous avez configure votre serveur devaluation comme nous I'avons 
indique au debut de ce chapitre. 
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10. Pour tester votre page dans le Web local de Wamp 5, ouvrez un navigateur en Web local (deroulez 
le menu du manager de Wamp 5 et selectionnez 1 ocal host) puis parcourez le repertoire du site 
SITEsport jusqu'a la page requetel . php. La valeur du premier niveau de cours doit s'afficher 
dans la page de la meme maniere qu'en Live Data (voir figure 18-15). 

Script de creation et de mise en forme d'un jeu d'enregistrements (voir repere 1 de la figure 18-13) : 
<?php 

requi re_once( ' . ./Connections/connexionSport .php' ) ; 

// Permet de disposer de la variable $database_connexionSport et 

// de 1 ' identificateur de connexion "SconnexionSport" cree 

// dans le fichier externe "connexionSport.php" 

mysql_select_db($database_connexionSport, $connexionSport) ; 

// Selection de la base sport_db memorisee 

// dans la variable $database_connexionSport 

$query_rsRappelNiveaux = "SELECT niveau FROM cours"; 

// Redaction de la requete SQL 

// dans la variable $query_rsRappel Niveaux 

$rsRappelNiveaux = mysql_query($query_rsRappelNiveaux, SconnexionSport) or die(mysql_error( ) ) ; 
// Soumission de la requete et recuperation 
// du pointeur du jeu d'enregistrements 
// dans la variable SrsRappelNiveaux 

$row_rsRappelNiveaux = mysql_fetch_assoc($rsRappel Niveaux) ; 

// Transformation de la premiere ligne 

// du jeu d'enregistrements dans un tableau associatif 

?> 

Script d'utilisation d'un element du jeu d'enregistrements (voir repere 2 de la figure 18-13) : 
<?php 

echo $row_rsRappel Niveaux[ 'niveau' ] ; 

// Affiche la valeur du champ nom 

// de la premiere ligne du jeu d'enregistrements 

?> 

Script de liberation de lamemoire utilisee par le jeu d'enregistrements (voir repere 3 de la figure 18-13) : 
<?php 

mysql_free_result($rsRappel Niveaux) ; 

// Libere la memoire utilisee par la requete SrsRappelNiveaux 



Figure 18-15 

Test de la page 
dynamique requetel. php 
dans le Web local 
deWamp 5 
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Chapitre 18 



Exploitation d'un jeu d'enregistrements 

Apres la soumission de la requete a la base de donnees, celle-ci renvoie un pointeur qui ne peut pas 
etre exploite directement. En effet, les resultats renvoyes par une base de donnees peuvent etre conse- 
quents et il n'est pas concevable d'enregistrer systematiquement la totalite de ces informations. 
II faut done utiliser une fonction de recuperation des resultats afin de parcourir chacune des lignes du 
jeu d'enregistrements. 

Ces differentes fonctions de recuperation (de type mysql_fetch_xxx) sont presentees dans le 
tableau 18-1. Dans l'exemple precedent, nous en avons d'ailleurs utilise une pour recuperer le champ 
nom de la premiere ligne du jeu d'enregistrements. Cependant, en pratique, vous aurez souvent 
besoin d'exploiter les resultats des differentes lignes du jeu d'enregistrement. Nous vous proposons 
done d'etudier deux techniques de recuperation des resultats issus d'un jeu d'enregistrements (par 
affichage direct a l'ecran ou par transfert dans un tableau de variables). 

Affichage des differentes lignes d'un jeu d'enregistrements 

Cette premiere technique permet d'afficher toutes les lignes d'un jeu d'enregistrements dans une 
page dynamique. Pour chaque ligne, seuls certains champs du jeu d'enregistrements seront affiches 
(voir figure 18-17). Pour illustrer cette technique, nous afficherons la liste des differents niveaux de 
cours en precisant le jour et l'horaire correspondants. Le script sera enregistre dans un fichier 
requete2.php dans le meme repertoire sport/ que le premier script. 

Pour derouler toutes les lignes du jeu d'enregistrements, utilisez une boucle whi 1 e dont la condition 
de boucle sera realisee par l'execution d'une fonction mysql_fetch_asso( ). Ainsi, des que vous 
atteindrez la derniere ligne du jeu d'enregistrements, la fonction mysql_fetch_asso( ) retournera une 
valeur nulle, stoppant automatiquement la boucle while et du meme coup l'affichage des lignes du 
jeu d'enregistrements. 



Dans le cas d'un affichage partiel des champs de chaque ligne, il est plus judicieux d'utiliser une fonction 
mysql_f etch_asso( )- qui permet de recuperer chaque valeur des champs a I'aide de son nom dans un tableau 
associatif (exemple : $row_rs[ 'nom' ]) — qu'une fonction mysql_fetch_row( ) — pour laquelle il faut connaitre 
I'indice correspondant a chaque champ (exemple : $row_rs[2]). 



Script de creation du jeu d'enregistrements (voirrepere 1 de la figure 18-16) : 
<?php 

requi re_once( ' . ./Connections/connexionSport.php' ) ; 
mysql_select_db($database_connexionSport, SconnexionSport) ; 
$query_rsl_i steCours = "SELECT * FROM cours"; 

SrsListeCours = mysql_query($query_rsl_isteCours, SconnexionSport) or die(mysql_error( ) ) ; 
?> 

Script d' affichage du jeu d'enregistrements (voir repere 2 de la figure 18-16) : 



A noter 



<?php 

// Affichage de la liste des cours sur une ligne differente 
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while($row_rsListeCours = mysql_fetch_assoc($rsListeCours)) { 
echo "Le cours de niveau <b>" . $row_rsListeCours[ 'niveau' ]. "</b>" ; 
echo " a lieu le <b>" . $row_rsListeCours[ ' jour' ] . "</b>" ; 
echo " a <b>".$row_rsListeCours['horaire , ]."</b> heure <br>"; 
} 

?> 

Script de liberation de la memoire utilisee par le jeu d'enregistrements (voir repere 3 de la 
figure 18-16) : 

<?php 

mysql_free_result($rsListeCours) ; 
?> 
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▼ Application 

E-3',e-; de donnees 
® B Type de document :PHP 



: 

e<pUte_once( ' . . /Connectlons/connexionSport.php' ) ; 
.ysql_select_db(*dacabase_connexionSpoEt, (connexionSport); 
query_rsLi3teCours - "SELECT ■ FROH cours"; 

rsListeCours ■ »ysql_query ((query_rsListeCour3, (connexionSport) or die(Mysql_error () ) ; 



I <htalXheadXBeta http-equiv*" Content-Type" content»"text/ht»l; chai:set»l30-8859-l*'> 

I <ticle>Requete K/titlex/headXbody>PAGE DE LA REQUETE Kbr> 

Ivoici la liste des niveau* avec les jours et horaires correspondents : <bc> 



12 
13 


-TO 


2 


14 


while (Srov_r3Ll3teCours » »ysql_E>tch_a3soc (SrsllsteCours) ) ( 




15 


echo "Le cours de niveau <b>". f row_tsLi3teCouES[ 'niveau' ]."</b>"; 




16 
17 


echo " a lieu le <b>".(row_rsLl3teCour3( 'jout' ]."</b>**; 

echo " a <b>".5row_rsLiswCour3[ 'horaire' ]."</b> heure <br>"; 




ie 


I 






■ 




20 






21 


</bodyx/ht»l> 




22 






23 




3 


24 

25 


»ysql_tEee_result((E3Ll3teCouES) ; 
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Figure 18-16 

Script de la page dynamique requete2.php 
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Figure 18-17 

Test de la page dynamique requete2.php dans le Web local de Wamp 5 



Transfert d'un jeu d'enregistrements dans un tableau de variables 

Cette seconde technique permet de recuperer toutes les valeurs retournees par la base de donnees en 
les enregistrant dans un tableau de variables a deux dimensions. Pour illustrer cette technique, nous 
l'appliquerons au transfert de la table cours dans un tableau $tabl eauResul tat[ ] [ ]. 

Contrairement a l'exemple precedent, nous choisirons ici la fonction mysql_fetch_array( ), qui 
permet de recuperer une ligne de resultat dans un tableau indice (traitement a l'aide d'une boucle 
evoluant selon Findice du tableau, par exemple). 

Cette technique est tres interessante, car elle permet de transformer rapidement un jeu d'enregistrements 
en tableau de variables arm de traiter le resultat d'une requete. 

Pour verifier que les valeurs du tableau a deux dimensions correspondent bien a celles de la table 
cours, nous utiliserons la fonction print_r( ) pour afficher le resultat a l'ecran (voir figure 18-19). 

Script de creation du jeu d'enregistrements (voir repere 1 de la figure 18-18) : 

<?php 

requi re_once( ' . ./Connections/connexionSport.php' ) ; 
mysql_select_db($database_connexionSport, SconnexionSport) ; 
$query_rsl_i steCours = "SELECT * FROM cours"; 

SrsListeCours = mysql_query($query_rsListeCours, SconnexionSport) or die(mysql_error( ) ) ; 
?> 

Script de transfert du jeu d'enregistrements dans le tableau a deux dimensions (voir repere 2 de la 
figure 18-18) : 

<?php 

$i=0;//init de 1 'indice du tableau 

while($row_rsListeCours = mysql_fetch_row($rsListeCours) ) { 
$tabl eauResul tat [$i ]=$row_rsLi steCours ; 
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//affectation d'une ligne d'enregistrement 
$i++;//incrementation de 1'indice du tableau 
} 

?> 

Script d'affichage du jeu d'enregistrements (voir repere 3 de la figure 18-18) : 
<?php 

echo "<pre>"; 

print_r($tableauResultat) ; 
echo "</pre>"; 

echo '<br> Pour exemple, voici la valeur de $tableauResultat[2][3] =' .$tableauResultat[2][3]; 

?> 

Script de liberation de la memoire utilisee par le jeu d'enregistrements (voir repere 4 de la figure 18-18) : 
<?php 

mysql_free_result($rsl_isteCours) ; 
?> 
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r- 



kequiteonce ( ' . . /Connections/connexionSpoEt. php ' ) ; 1 
tasql_select_db(*database_connexionSpoEt, SconnexionSpott) ; 
kquety_tsListeCouES - "SELECT • FFOh" cours"; 

KtsListeCouES - BY3ql_queiy((query_tsLi3teCouES, (connexionSport) ot die(»ysql_eEEOE ( ) ) ; 



: £j) connexionSport 



I <htal><head><Beta http-equlv«" Content-Type" content*"text/ht»l; charset»lso-88S9-l"> 
I <title>Requete 3</tltlex/head><body>PAGE DE LA REQUETE 3<bc> 
I Contenu du tableau (tableaup.esultat[][] :<br> 









fi"0;//init de l'indicc d 


i tableau 


2 


>hile((Eow_rsLl3teC0UE3 * 


ttysql_t«tch_Eou(CE3Li»teCouE3) ] { 




itableauResultat[<i]>(iow. 


.nLiattCouE8;//aCCectation d'une ligne d'enEegistEemenc 




r / / inc e eaenta 1 1 on de 







► Inspecteur de batses 




•cho "<pEe>"; 

;r.int_t (StableauResultat) ; 

ChO "</pEt>"; 

iCbO '<bt> Pouc exemple, voici la valeuE de (tableauResultatf,2][3] = ' . StabieauResultatt 2 ] [ 



I <7body></ht*l> 







iys<il_f Eee_Ee3ult(<E3ListeCow:3) ; 


4 



► PrapMtfc 



LJ SITEspott 



& o I $ ♦ <y * I a 



5 O S*e • SlTEsport (C:\wano\wwwlSI7Esport) 
H £3 Connections 

a connexionSpOfl.php 
B G sport 

4C requetel.php 



> 



f) 1 *fements loc aun seten.:cf ,-t totals | Journal... ] 



Figure 18-18 

Script de la page dynamique requete3.php 
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3 Rcquctc 3 - Microsoft Internet Explorer 
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PAGE DE LA REQUETE 3 

Contenu du tableau $tableauResultat[][] 



Array 

( 



[0] -> Array 



(0) -> 1 

tl] -> 2 

[2] -> Debutant 

[3] -> uardl 

[4J -> 19 



[1] -> Array 



[0] -> 2 

[1] -> 1 

[2] -> Intermediate 

[3] ■> samedi 

in -> ie 



) 



^m^-> Array 

[0] -> 3 
tl] -> 1 




Figure 18-19 

Test de la page dynamique requete3.php dans le Web local de Wamp 5 



Construction d'une requite SQL 

Dans les exemples presentes ci-dessus, nous avons utilise une requete SQL non parametrable 
(exemple : $query="SELECT * FROM adherents"). Cependant, en pratique vous aurez souvent a creer 
une requete SQL dont les elements sont issus de variables envoyees par un formulaire, dans l'URL ou 
encore par le biais d'une application Flash. Voici deux techniques de personnalisation d'une requete 
SQL (a partir d'une variable obligatoire ou de variables optionnelles). 

Construction d'une requete a partir d'une variable obligatoire 

Cette premiere technique permet d'afficher la liste des adherents dont l'annee de naissance est supe- 
rieure a une annee donnee (voir figure 18-20). Pour realiser cette petite application, nous allons 
d'abord creer un formulaire HTML (formulaire4.htm) dans lequel sera integre un champ de saisie 
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nomme anneeNaissance. Ce fonnulaire (voir figure 18-20) sera configure pour envoyer ses donnees 
en methode POST a un script requete4.php que nous realiserons dans un second temps. 
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S) B Type de document :HTML 



Uaisons Comport em Composants 



jsq |ico |iso |zoo pff; poo Iffi,,., ftjQ |ssq ft« lffi.i..T7ffi 



• a 



FORMULAIRE DE RECHERCHE D'UN ADHERENT 



Indique; I'annee a partir de laquelle les adherents doiyents etre affiches : [*"] Puis yalidez : [ VAUDBc | 




<body> <o.5tvtel> 



i> fl^ 10O% » 713x516- IKo/ls 



► Proprietes 



£j SITEsport 



v Alfichacje local v 



- C_> Ste • SITEsport (C:\warre\twm\SITEspoft) 
E O Connections 

?I connexionSport.php 
B Q sport 

_ -33 requetel.php 
91 requete2.php 



1 elements locaux selecticnnes totals I Journal... ] 



Figure 18-20 

Fonnulaire de saisie de I'annee de naissance : formulaire4.htm 



Le script PHP requete4 . php receptionne la variable envoyee par le formulaire. Cette variable person- 
nalise la clause WHERE de la requete SQL pour selectionner uniquement les adherents dont I'annee de 
naissance est superieure a la valeur transmise (soit SanneeNaissance). La premiere ligne du script 
permet d'initialiser la variable SanneeNaissance avec la valeur de la variable HTTP correspondante 
transmise par la methode POST ($_P0ST[ ' anneeNai ssance ' ]). 

Les deux lignes qui suivent permettent d'etablir une connexion avec le serveur MySQL et de selec- 
tionner la base sport_db : 

I requi re_once( ' . ./Connections/connexionSport.php' ); 

mysql_select_db($database_connexionSport, $connexionSport) ; 
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A noter 

L'instruction d'initialisation est conditionnee par un test qui determine si la variable HTTP existe (i sset( )). Dans le 
cas contraire, la variable SanneeNai ssance est initialisee avec une valeur par defaut (1900 dans notre exemple) 
afin d'eviter I'affichage a I'ecran d'un message signalant que la variable est indefinie (voir repere 1 de la figure 1 8-21 ). 

if (i sset($_P0ST[ ' anneeNai ssance' ] ) ) SanneeNai ssance=$_P0ST[ ' anneeNai ssance '] ; 
else $anneeNaissance="1900" ; 
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con,™., - ^is*|igaii-#-sae3|B-e' 



l^jjCode ^jFracttonrw j j|Cre*on Jf lure: [Requete* 



requete l.php fequete2.php requete3.php forrraiwH.htm 



reque*e4.php 



at 9. c 



C(iSSet(f_POST[ 'aimeeValSSance' ]) ) ^TameeHaissance^^^j^ '«""«»"»' ■ j • else <anneeHai3sance=>"19Ci0"; 



I requite_once ( ' . . /Connect: 
I »y3ql_select_db ((database 
I *quety_tsLi3teAdhetent3 - 
I (csListeAdhecenu ■ aysql 
I ?> 




Construction de la requete SQL 



I <htal><head><neta http-equiv«" Content -Type" content""text/ht»l ; chatset"iso-8859-l"> 
I <title> Requete 4</titlex/headxbody^PAGE DE LA REQUETE 4<bt> 

I Voici la liste des adherents nes aptes <b> :>phi> echo f anneeHaissance; ?> </b>: <br> 





Jhiie($Eov_r3Li3teAdherents - ■Y3ql_fecch_assoc(<LsLlsceA<lherenC3) ) ( 
icho "L'sdherent <b>". t Eow_E3Li3teAdhecents[ 'noi 1 ] ."</b>"; 
•cho " - <b>".*cow_E3Li3teAdhecents[ 'pcenoa' ]."</b>"; 

;cho " est ne(e) en <b>". t EOV_E3L13teAdheEents[ ' enneeNalssance ' ] . "</b> <bE>" 





|</body></htal> 

I »Ysql_Ccee_i:e3ult((E3H3teAdheEent3) ; 



► Prowletei 



Figure 18-21 

Script de la page dynamique requete4.php 



La creation de la requete est realisee par concatenation de la variable SanneeNai ssance avec le debut 
de la requete (voir repere 2 de la figure 18-21). Lors de F execution du script, la requete est reconstituee 
avant d'etre transmise au serveur MySQL via la fonction mysq"Lquery ( ) : 

$query_rsLi steAdherents = "SELECT nom, prenom, anneeNaissance FROM adherents WHERE 
^•anneeNaissance > ".SanneeNaissance ; 

SrsListeAdherents = mysql_query($query_rsl_isteAdherents, SconnexionSport) or 
*»die(mysql_error( ) ) ; 
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Les donnees du jeu d'enregistrements sont mises en forme avec la meme methode que dans l'exem- 
ple de la requete 2 (voir repere 3 de la figure 18-21). Les differentes lignes du resultat sont affichees 
dans le corps de la page (voir figure 18-23) : 

while($row_rsl_isteAdherents = mysql_fetch_assoc($rsListeAdherents)) { 
echo "L'adherent <b>".$row_rsListeAdherents['nom']."</b>"; 
echo " - <b>" . $row_rsListeAdherents[ 'prenom' ] . "</b>" ; 

echo " est ne(e) en <b>".$row_rsListeAdherents['anneeNaissance']."</b> <br>"; 
} 

Une fois le script termine, enregistrez-le, puis passez dans le Web local pour acceder au formulaire. 
Saisissez une annee dans le champ (1970, par exemple) puis validez (voir figure 18-22). Si votre 
application fonctionne correctement, la page du script affiche la liste des adherents repondant a la 
condition (voir figure 18-23). 
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Qprecedente ' Q ' [*} ^Rechercher ^Favons ^Meda 
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Ajjesse $] http://127.0.0. l/SITEsport/sport/formulaire4.htm 
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FORMULAIRE DE RECHERCHE D'UN ADHERENT 



Indiquez I'annee a partir de laquelle les adherents doivents etre affiches : 1970 pJs validez : I VAUDER 



Figure 18-22 

Pour tester V application, affichez le formulaire dans le Web local, saisissez une annee dans le champ, puis validez 
votre choix. 
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PAGE DE LA REQUETE 4 
Voici la liste des adherents nes apre£l9T), 
L'adherent Dmnonlin - Alice est ne(e) en 19S0 
L'adherent C'hanviei - Christian estne(e) en 19"2 
L'adherent Hainoml - Laiuence est ne(e) en 1985 



Figure 18-23 

Des reception de la variable HTTP envoy ee par le formulaire, le script doit afficher la liste des adherents dont I'annee 
de naissance est superieure a la valeur saisie. 
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Construction d'une requete a partir de variables optionnelles 

Ce deuxieme exemple sera l'occasion de presenter la technique de construction d'une requete a l'aide 
d' operations de concatenation successives conditionnees en fonction de F existence d'une variable 
specifique. Cette fois, les variables utilisees dans les clauses de la requete sont au nombre de trois et 
peuvent etre optionnelles. La table interrogee est la table adherents et les trois variables transmises 
correspondent aux criteres suivants : 

• selection selon le cours auquel est inscrit l'adherent : variable coursID ; 

• selection selon la date de naissance de l'adherent : variable anneeNai ssance ; 

• selection selon la premiere lettre du nom de l'adherent : variable 1 ettreNom. 

Les variables de selection ne sont pas transmises par un formulaire mais directement dans FURL 
derriere le nom du script (exemple: requete5.php?coursID=l&anneeNaissance=1972). Le script 
requete5 . php recupere ensuite les variables HTTP (en methode GET) et elabore la requete en fonction 
de l'existence de chacune d'elles (les variables etant optionnelles). 

Pour la creation du fichier PHP, utilisez la base du fichier requete4.php precedent, que vous renom- 
merez requete5.php. Cela vous permet de conserver la meme structure pour le script et d'apporter 
uniquement quelques modifications au niveau de la creation de la requete et dans la boucle d'affi- 
chage des informations. 

La ligne d'initialisation du precedent script n'est pas obligatoire car nous allons conditionner Futili- 
sation des variables lors de la creation de la requete. 

Les deux lignes destinees a etablir la connexion avec le serveur MySQL sont identiques (voir repere 1 de 
la figure 18-24). En revanche, Fenregistrement de la requete se fait sur quatre lignes (voir repere 2 de la 
figure 18-24). 

La premiere ligne permet d'initialiser la variable de la requete $query_rsl_isteAdherents avec la 
partie fixe de la requete SQL. Les trois criteres etant optionnels, une premiere clause WHERE 1=1 est 
ajoutee afin que la requete puisse fonctionner si aucune variable n'est passee dans FURL : 

$query_rsl_isteAdherents = "SELECT nom, prenom, anneeNaissance, coursID FROM adherents 
| *WHERE 1 = 1 "; 

La deuxieme ligne permet de conditionner l'ajout de la clause AND coursID= $_GET['coursID'] a la 
suite de la requete initiale. Si la variable $_GET['coursID'] n'est pas passee dans FURL, cette clause 
(en gras ci-dessous) n'est pas ajoutee : 

if(isset($_GET['coursID'])) $query_rsListeAdherents .= " AND coursID=" .$_GET[ 'coursID' ] ; 

Les troisieme et quatrieme lignes fonctionnent sur le meme principe mais avec les variables 
$_GET[" anneeNai ssance'] et $_GET[ ' 1 ettreNom' ]. 

La ligne qui suit recupere la requete ainsi elaboree et Fenvoie au serveur a l'aide de la fonction 
mysql_query( ) (voir repere 3 de la figure 18-24) : 

SrsListeAdherents = mysql_query($query_rsl_isteAdherents, SconnexionSport) or die(mysql_error( ) ) ; 

Si aucun enregistrement ne correspond a la requete envoyee, nous desirons que s'affiche a Fecran le 
message « AUCUN RESULTAT ». Laffichage de ce message etant conditionne par un nombre de 
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resultat nul, initialisons des maintenant une variable a l'aide de la fonction mysql_num_rows() afin de 
preparer la condition du futur test : 



$nombreResultat=mysql_num_rows($rsl_isteAdherents) ; 
// Recupere le nombre de resultats 
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<0 tf>. at ft, c OH 



y/ Etablisseaent de la connexion a la base de donnees 

pequiEe_once( ' . . /Connections/connexionSpOEt.php' ) ; 
pysql_select_db[*datttbase_connexionSpott, SconnexionSpott) ; 



queEY.rsLisceAdhetentS ■ "i-ELECT noli, jiEcr.ni,, ^j.^li^rjur:-, >7 .II i u. . - . "; 

£ (l3set(S_GET[ 'coursID' )) ) (query_EsLlsceAdherenu " AND couesID-". 5_GET[ 1 coursID ' ] ; 

t (i33et(t_GET[ 'anneeNaissance' ]) ) (quecy_csLi3teAdhecenw " AMD anneeNaissance > ".(_GET( 'anneeNaissance' J 
t (i33et(i_CET{ 1 letcteHo»' J) ) f quecy.rsListeAdheEents .- " AND noa LIKE ' ". (_GET{ ' letcceKOft' ]."% ' " ; 



noabEeResultat*aysql_nua_tou3 ($ EsLisceAdhetents) ; / /recupere noabte de resultats 



| <htalXhead><aeta http-equiv-" Content-Type" content-" eext/htal; chaEset-iso-86S9-l"> 
<tltle>Requete 5</tltleX/headXbody5|PAGE DE LA REQUETE S<br> Void la liste des adherents selectionnes : <bc> 



:(*noabreResultafO) echo "AUCUN RESULTAT'; else ( 



Sl'IIU 



vhile($EOW_isLl3teAdheEents - aysql_£etch_a3soc((c3Li3teAdhetents) ) ( 

echo "L'adhecent <b>". (rov_csLi3teAdhecents[ 'noa' ]."</b>"; 

echo " - <b>".<tow_csListeAdhecentst 'pcenoa' ]."</b> <bL>"; 

echo " ne(e) en <b>".(EOH_EsListeAdhetents[ 'anneeNaissance' ]."</b> <bE>"; 

echo " est lnsctit dans le couts <b>". (Et>«_E3ListeAdheEents[ 'coursID' ]."</b> <bt>" 

echo " <br>" ; 



I aYsql_CEee_Eesult((r3H3teAcIheEent3) ; 



► Propriety 



Figure 18-24 

Script de la page dynamique requete5.php 



A noter 

Pour la clause AND nom LIKE, la variable et le signe % qui la suit doivent etre encadres par des guillemets simples 
afin de respecter la syntaxe SQL : 

if ( isset($_GET[ ' anneeNaissance' ] ) ) $query_rsLi steAdherents .= 

AND anneeNaissance > ".$_GET['anneeNaissance'] ; 
if(isset($_GET['lettreNom'])) $query_rsListeAdherents .= 

AND nom LIKE ' " . $_GET[ ' 1 ettreNom' ] . "% ' " ; 
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Le script destine a afficher les resultats est conditionne afin d'afficher les resultats de la requete 
uniquement si le nombre d'enregistrement retourne par le serveur est different de zero. Dans le cas 
contraire, un message indique qu'aucun resultat ne correspond a la recherche. 

La structure de la boucle while est identique a celle de l'application precedente, hormis le fait que 
nous afficherons le numero du cours (cours ID) en complement : 



// Affichage de la liste des adherents 

if($nombreResultat==0) echo "AUCUN RESULTAT"; else { 
echo " <br>"; 

while($row_rsListeAdherents = mysql_fetch_assoc($rsListeAdherents) ) { 
echo "L'adherent <b>".$row_rsListeAdherents['nom']."</b>"; 
echo " - <b>".$row_rsListeAdherents['prenoin']."</b> <br>"; 
echo " ne(e) en <b>".$row_rsListeAdherents['anneeNaissance']."</b> <br>"; 
echo " est inscrit dans le cours <b>" .$row_rsListeAdherents[ 'coursID' ] . "</b> <br>"; 

echo " <br>"; 

} // Fin du while 
} // Fin du else 

Comme dans tous les scripts de requete, ajoutez a la fin une fonction mysql_free_result( ) arm de 
liberer la memoire utilisee par le jeu d'enregistrements : 

mysql_f ree_result($rsListeAdherents) ; 

Enregistrez votre script et passez dans le Web local pour le tester. Si vous affichez la page directement 
sans ajouter de variable dans FURL, la totalite des adherents s'affiche. Vous pouvez ensuite saisir 
differentes combinaisons de variables directement dans FURL afin de verifier que le script selec- 
tionne bien les adherents correspondants (voir figure 18-25). 

Exemples de combinaisons de plusieurs criteres de selection a saisir dans FURL : 

requete5.php?coursID=3 
requete5.php?lettreNom=D 
requete5.php?coursID=3&anneeNai ssance=1972 
requete5.php?coursID=3&l ettreNom=C 
requete5.php?coursID=l&l ettreNom=D&anneeNaissance=1975 



Figure 18-25 

Test de la page dynamique 
requete5.php 
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Pages d'administration d'une base de donnees 

Nous vous avons presente differents exemples utilisant des requetes SQL (commande SELECT). 
En pratique, vous serez amene a utiliser d'autres commandes SQL pour administrer votre base 
de donnees. Voici trois pages dynamiques courantes pour ajouter (commande INSERT), modifier 
(commande UPDATE) ou supprimer un enregistrement (commande DELETE) (voir figure 18-26). 
Ces trois pages permettent d' administrer une seule table mais il vous suffit de dupliquer cette struc- 
ture et de 1' adapter aux autres tables si vous souhaitez administrer completement la base de 
donnees. 

Commandes d'administration d'une table : 

Ajout d'un enregistrement : INSERT ». 

Suppression d'un enregistrement : DELETE ► 

Modification d'un enregistrement : UPDATE ► 



Figure 18-26 

Structure d'administration d'une table 

Page d'ajout d'un enregistrement 

Pour illustrer le fonctionnement de ces trois pages, nous allons administrer la table adherents. La 
page d'ajout d'un nouvel enregistrement est constitute d'un formulaire dont les champs correspondent 
aux champs de la table et d'un script d'insertion des donnees dans la table. 

1. Creez une nouvelle page dynamique dans Dreamweaver (Fichier>Nouveau>Page dynami- 
que>PHP). Enregistrez cette page sous le nom adherentsAjout.php (par la suite, vous pourrez 
appliquer la meme convention de nommage pour les autres tables). 

2. Passez en mode creation. Ajoutez un titre en haut de la page (PAGE D'AJOUT, par exemple) puis 
cliquez sur le bouton Formulaire du panneau Formulaire de la barre d'outils Inserer (voir repere 
1 de la figure 18-27). 

3. Creez a l'interieur du formulaire un tableau HTML de cinq lignes et deux colonnes (utilisez pour 
cela le bouton Tableau du panneau Commun de la barre d'outils Inserer). Dans la colonne de 
gauche, saisissez les libelles correspondant a chaque champ de saisie (voir figure 18-27). Dans la 
colonne de droite, inserez un champ texte de saisie (utilisez le bouton Champ de texte du panneau 
Formulaire de la barre d'outils Inserer ; voir repere 2 de la figure 18-27) dans les trois premieres 
lignes et nommez-les respectivement nom, prenom et anneeNaissance. Selectionnez le champ de la 
date de naissance et configurez sa largeur et son nombre maximal de caracteres a 4 dans le 
panneau des proprietes. 

4. Dans la cellule de la quatrieme ligne de la colonne de droite, inserez un element Liste/Menu 
(utilisez le bouton du repere 4 de la figure 18-27), puis nommez-le coursID. Renseignez ensuite 



TABLE 

enregistrement 1 
enregistrement 2 
enregistrement 3 
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les valeurs et les etiquettes des options (valeur 1 pour Fetiquette Debutant, valeur 2 pour 
Fetiquette Intermedial re et valeur 3 pour Fetiquette Perfectionnement). 

5. Dans la derniere ligne, ajoutez un bouton de soumission (utilisez le bouton du repere 5 de la 
figure 18-27) dans la cellule de droite et un champ cache dans la cellule de gauche (utilisez le 
bouton du repere 3 de la figure 18-27). Nommez le champ cache action et attribuez-lui la valeur 
ajout. 

6. Selectionnez le formulaire (placez votre curseur dans une des cellules du formulaire puis cliquez 
sur la balise <form> dans le selecteur de balise ; voir repere 6 de la figure 18-27). Une fois le 
formulaire selectionne, renseignez le champ Action du panneau de proprietes avec le nom du 
fichier actuel adherentsAjout.php (voir repere 7 de la figure 18-27). Assurez-vous que la methode 
POST est bien selectionnee dans le panneau Proprietes. 
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Figure 18-27 

Creation du formulaire a" ajout dans Dreamweaver (en mode creation) 



Base de donnees MySQL 

Partie V 

I. Passez maintenant en mode code (en cliquant sur le bouton Code situe en haut et a gauche de la 
zone de travail ; voir repere 1 de la figure 18-28). 

8. Saisissez autant de lignes d'initialisation de variable qu'il y a de champs dans le formulaire sans 
oublier le champ cache (voir repere 2 de la figure 18-28) : 

// INITIALISATION DES VARIABLES 

if(isset($_POST['nom'])) $nom=$_P0ST[ ' nom' ] ; else $nom=""; 
if(isset($_POST['prenom'])) $prenom=$_POST[ 'prenom' ] ; else $prenom=° n ; 
if (isset($_POST[ 'anneeNaissance' ]) ) $anneeNaissance=$_POST[ 'anneeNaissance' ] ; 
**else $anneeNaissance="" ; 

if(isset($_POST['coursID'])) $coursID=$_POST[ ' coursID' ] ; else $coursID="" ; 
if(isset($_POST['action'])) $action=$_POST[ 'action']; else $action=""; 

9. Saisissez les deux lignes qui permettent de vous connecter au serveur et de selectionner la base 
(voir repere 3 de la figure 18-28) : 

// CONNEXION ET SELECTION DE LA BASE 

requi re_once( ' . . /Connections/connexionSport . php ' ) ; 
mysql_select_db($database_connexionSport , $connexionSport) ; 

10. Construisez une structure de test conditionnee par l'egalite action=="ajout" (information du 
champ cache du formulaire) afin de determiner si la page est appelee suite a l'envoi du formulaire 
(voir repere 4 de la figure 18-28) : 

// TESTE SI ENVOI DEPUIS FORMULAIRE 

if ($action=="ajout") { 

// Ici le bloc conditionne 

) 

II. Dans le bloc conditionne par la structure de test, saisissez l'expression d'elaboration de la 
requete SQL (voir repere 5 de la figure 18-28), suivie de 1' instruction de soumission de 
la requete : 

// REQUETE SQL 

SinsertAdherents = "INSERT INTO adherents SET 

nom=' " .$nom. " ' , 

prenom=' " .Sprenom. " ' , 

anneeNai ssance=' " . SanneeNai ssance. " ' , 

coursID=" .ScoursID. "" ; 

// SOUMISSION REQUETE 



mysql_query($insertAdherents, SconnexionSport) or die(mysql_error( ) ) ; 
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C(lsset(«_FOSTl , coursII>'])) «coursID-«_P05T[ 'coursID' J; else fcoursID-""; 
f (i3set((_P05T['action'])) $acUon*S_P03T[ 'action' ]; else (action-""; 



equlte_once( ' . . /Connections /connexionSpoLt.php* ) ; 
ysql_select_db (f database_connexionSpott, (connexlonSpoit) ; 



quety_tsLlsteCour» - "SELECT • FROH cours ORDER BY ID"; _ 
tallateCouts - *ysql_query((qviety_t3Ll3teCouE3, (coimextonSpott) oe dle(»y3ql_eti:oEoV 

/ TEST SI EHVOI DEPUIS FORHULAIRZ 

C((action-»"ajout") ( 



inseetAdhe cents • "INSERT TJTTO adherents SET 

»""".(noB.*", 

enoa- ' " . f pcenoa. " ' , 
nneeHalssonce- ' ".(anneeHaissance. " 1 , 
oursID*". (COUCSlD. "~ ; 



»ysql_quety(( lnsettAdbetentJ, (connexlonSpoit) ot dle(»ysql_enotO); 
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Figure 18-28 

Modification du code de la page adherents Ajout.php 

12. Enregistrez le fichier et passez en Web local pour tester son fonctionnement (voir figure 18-29). 

13. Remplissez le formulaire en saisissant des informations plausibles (notamment en ce qui 
concerne l'annee de naissance) et cliquez sur le bouton pour valider votre saisie (voir figure 18-29). 
Apres validation, vous pouvez verifier avec phpMy Admin que les donnees ont bien ete enregistrees 
dans la table adherents (voir figure 18-30). 
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Test du formulaire d'ajout 
d'un adherent depuis le Web 
local 
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Figure 18-30 

Apres un ajout, vous pouvez verifier que le nouvel adherent a bien ete ajoute dans la table adherents avec phpMyAdmin 



Affichage dynamique du menu (option) 

Actuellement, le menu deroulant (correspondant aux niveaux de cours) est configure directement dans 
le code HTML de la page. Cependant, si Ton ajoute un quatrieme niveau de cours, il faudra intervenir 
sur cette page pour modifier les options de Fobjet de formulaire sel ect. En pratique, il est preferable 
que ce menu soit dynamique ann que les options qu'il affiche s'actualisent automatiquement des qu'un 
nouvel enregistrement est ajoute dans la table cours. Voici les modifications a effectuer pour ce faire : 

1. Ouvrez le fichier adherentsAjout.php et ajoutez les instructions en gras dans le script ci-dessous 
apres les deux lignes qui etablissent la connexion et selectionnent la base. Ces instructions 
complementaires permettent de creer un nouveau jeu d' enregistrements SrsListeCours qui 
contient les colonnes ID et niveau de la table cours : 

// CONNEXION ET SELECTION DE LA BASE 

requi re_once( ' . ./Connections/connexionSport.php' ); 



Interfacage Flash-PHP-MySQL 

Chapitre 18 



mysql_sel ect_db($database_connexionSport , SconnexionSport) ; 



// RECUPERATION DES INFORMATIONS DE LA LISTE DEROULANTE "COURS" 

$query_rsListeCours = "SELECT ID, niveau FROM cours ORDER BY ID"; 

SrsListeCours = mysql_query($query_rsListeCours, SconnexionSport) or die(mysql_error( ) ) ; 

2. Descendez plus bas dans la page au niveau du code de l'objet select. Nous desirons remplacer 
les valeurs et les etiquettes des options par les donnees issues du jeu d'enregistrements cree 
precedemment. Ann que le nombre d' option corresponde au nombre d'enregistrements dans la 
table cours, integrez les balises de Foption dans une boucle whi 1 e comme nous l'avons fait dans 
un precedent exemple de requete. 

3. Remplacez le code de l'objet rappele ci-dessous : 

<select name="coursID" id="coursID"> 
<option val ue="l">Débutant</option> 
<option val ue="2">Intermédiai re</option> 
<option val ue="3">Perfectionnement</option> 
</select> 

par celui-ci : 

<select name="coursID" id="coursID"> 

<?php while($row_rsListeCours = mysql_fetch_assoc($rsListeCours) ) { ?> 

<option value="<?php echo $row_rsListeCours[ ' ID' ] ; ?>"><?php echo $row_rsListeCours 

niveau' ] ; ?></option> 
<?php } ?> 
</select> 



Table : adherents 

♦-T" - * ID comsID nom pienom aniieeH.ilss.)iice 
A m \ 2 Oeftance Jean-Mane 1960 




Figure 18-31 

Schema de principe illustrant la requete SELECT destinee a configurer dynamiquement le menu deroulant d partir de 
la table cours ( repere 1) et la commande INSERT qui permet d'ajouter un nouvel enregistrement dans la table 
adherents (repere 2). 
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4. Enregistrez votre fichier et testez-le dans le Web local. Le fonctionnement du menu doit etre identique 
a celui des tests precedents. Cependant, si vous ajoutez un enregistrement dans la table cours (avec 
phpMy Admin, par exemple), il doit apparaitre automatiquement dans la liste des options du menu. 

Enregistrement dynamique d'un fichier (option) 

II faut souvent gerer des images ou des fichiers PDF dynamiquement. Dans ce cas, il faut memoriser 
FURL du document dans la base de donnees et enregistrer le fichier lors de la procedure d'ajout d'un 
enregistrement. Pour illustrer cette technique, nous vous proposons de modifier le formulaire precedent 
afin d'inclure la photo de F adherent : 

1. A Faide du gestionnaire phpMyAdmin, ajoutez un champ supplemental nomme photo dans la 
table adherents apres le champ prenom (type VARCHAR de 200 caracteres au maximum) (revoir si 
besoin le chapitre 16). 

2. Dans le fichier adherentsAjout.php, ajoutez les lignes de code suivantes afin d'enregistrer le 
document dans un repertoire dedie (par exemple /photos/). Attention ! si vous utilisez ce script 
sur votre serveur distant, modifiez au prealable les droits du repertoire avec CHMOD. Dans ce 
script, Faction de copier le fichier est conditionnee par une structure de choix if qui teste la 
selection prealable d'un fichier dans le formulaire (a Faide du bouton Parcourir). Si aucun fichier 
n'est selectionne, le nom d'une photo par defaut sera affecte a la variable Snomphoto : 

if ($action=="ajout") { 

if ($_FILESf ' photo'] ['name' ]!="") 

{ 

$nomphoto='photo_' .$nom. ' . jpg' ; 

copy ($_FI LES [ 'photo' ] [ ' tmp_name ' ] , ' . . /photos/ ' . $nomphoto) ; 
}el se{ 

$nomphoto=' photo_defaut.jpg' ; 
} 

3. A la suite de ce premier script, modifiez la requete afin d'ajouter le couple champ/variable corres- 
pondant au nom de la photo (voir code en gras ci-dessous). Attention ! dans la requete SQL, 
n'oubliez pas d'encadrer la variable "Snomphoto" avec des guillemets simples car FURL de la 
photo est consideree comme un champ texte : 

// REQUETE SQL 

SinsertAdherents = "INSERT INTO adherents SET 

nom=' " . $nom. " ' , 

prenom= ' " . Sprenom. " ' , 

anneeNai ssance=' " . SanneeNai ssance. " ' , 

coursID=" . ScoursID. " , 

photo=' " . $nomphoto ; 

// SOUMISSION REQUETE 

mysql_query($insertAdherents, $connexionSport) or die(mysql_error( ) ) ; 
header ( "Location : adherent sGest ion .php" ) ; 
} // Fin du if($action) 

4. Dans le formulaire de cette meme page, ajoutez un champ de fichier et nommez-le photo : 
| <input name="photo" type="file" id="photo"> 

5. Enregistrez votre page et testez son fonctionnement depuis le Web local. 



Interfacage Flash-PHP-MySQL 

Chapitre 18 



Page de suppression d'un enregistrement 

Pour gerer les suppressions d'enregistrements dans une table, on peut afficher un premier formulaire 
destine a selectionner F enregistrement a supprimer puis envoyer une commande de suppression a la 
base de donnees. Une autre solution consiste a afficher la liste de tous les enregistrements de la table 
concernee dans un tableau HTML. Au bout de chaque ligne d' enregistrement, un lien de suppression 
parametre dynamiquement permet d'appeler un script generant une commande DELETE. Ainsi, si Ton 
clique sur le lien d'un enregistrement, une commande de suppression est envoyee a la base de 
donnees et supprime F enregistrement concerne. Voici la procedure pour creer une page de suppression 
selon cette deuxieme methode : 

1. Ouvrez un nouveau document PHP et enregistrez-le sous le nom adherentsGestion.php. 
A noter 

Utilisez le suffixe Gestion et non Suppression pour nommer ce fichier car cette page sera egalement utilisee 
pour appeler le formulaire de modification presente ci-dessous. 

2. Passez en mode Creation afin de creer la structure du tableau HTML utilise pour afficher dynami- 
quement les differents enregistrements de la table adherents. Creez un tableau de deux lignes et 
cinq colonnes (utilisez le bouton Tableau du panneau Commun de la barre d'outils Inserer ; voir 
le repere 1 de la figure 18-32). Une fois le tableau cree, nommez les teres de quatre colonnes : 
Nom, Prenom, Supp. et Modif . (la colonne Modif. sera utilisee dans l'exemple de page suivant). 
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Figure 18-32 

Creation du tableau HTML pour la page adherentsGestion.php avec Dreamweaver en mode creation 
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C (i3set((_GETt 'action' )) ) fact±on»(_GETI 'action' ]; else faction-""; 
f(isset(S_GET[*ID'])) fID-f_GETt 'ID']; else HD-""; 



equire_once ( ' . . /Connections/connexionSpott. php ' ) ; 
ysql_select_db (fdatabaseconnexionSport, SconnexionSport) ; 



f (faction' •"suppression") ( 



aupAdherentS • "DELETE FROM adherents WHERE ID=".fID ; 
,ysql_query (f supAdberents, f connexions? or t) or die(*ysql_eEEor()); 



Iuery_rsLi3t*Adherents - "SELECT ■ FROH adherents ORDER BY nom"; 
:stisteAdherents ■ Mysql_query(f query_EsListeAdherent3, SconnexionSpott) or die( 
?sql_error ( ) ) ; 



l<'DOCTYP£ HTML PUBLIC "-//W3C//DTD HTML 4.01 Transltlonal/^EH" 
I "http: //wt).w3. org/TR/ht»14/loose.dtd"> 
I <ht»l> 
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Figure 18-33 

Script du haut de la page adherentsGestion.php 



Au-dessus du tableau, ajoutez un lien hypertexte afin de pouvoir appeler le formulaire d'ajout 
d'un nouvel adherent depuis cette page. Enfin, en haut de la page, placez le titre PAGE DE GESTION 
DE LA TABLE adherents (voir figure 18-32). 

1. Passez en mode code et positionnez votre curseur en haut de la page (au-dessus de la balise 
<html >). Ajoutez une balise d'ouverture de script PHP suivie des deux lignes de code (voir repere 1 
de la figure 18-33) destinees a initialiser les variables ID et action transmises par l'URL 
(methode GET) : 

<?php 

// INITIALISATION DES VARIABLES 

if(isset($_GET['action'])) $action=$_GET[ ' action '] ; else $action=""; 
if(isset($_GET['ID'])) $ID=$_GET[ ' ID' ] ; else $ID=""; 
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2. Ajoutez les deux instructions qui permettent d'etablir une connexion avec le serveur MySQL et 
de selectionner la base de donnees sport_db (voir repere 2 de la figure 18-33) : 

// CONNEXION ET SELECTION DE LA BASE 

requi re_once( ' . . /Connect i ons/connexionSport .php' ) ; 
mysql_sel ect_db($database_connexionSport , SconnexionSport ) ; 

3. Creez une structure de choix conditionnee par l'expression $action==" suppress ion" (voir repere 
3 de la figure 18-33). Vous pourrez ainsi determiner si la page est appelee suite a un clic sur un 
lien de suppression (adherentsGestion.php?action=suppression&ID=3 par exemple) : 

I if($action=="suppression") { 
//bloc conditionne 

4. Entre les accolades du bloc conditionne, placez les deux lignes de code qui permettent de constmire 
larequete SQL de suppression (parametree avec le ID de Fenregistrement a supprimer) suivies de 
1' instruction de soumission a la base de donnees (voir repere 4 de la figure 18-33) : 

// REQUETE SQL 

SsupAdherents = "DELETE FROM adherents WHERE ID=".$ID ; 
// SOUMISSION REQUETE 

mysql_query( SsupAdherents , SconnexionSport) or die(mysql_error( ) ) ; 

5. Apres l'accolade de fermeture du bloc conditionne, ajoutez les deux lignes de code qui permet- 
tent de creer le jeu d'enregistrements destine a recuperet - toutes les donnees de la table adherents 
(voir repere 5 de la figure 18-33). Ce jeu d'enregistrements sera ensuite utilise dans la construction 
dynamique du tableau HTML amchant la liste des adherents : 

// RECUPERATION DES INFORMATIONS DU TABLEAU HTML (depuis la table adherents) 

$query_rsListeAdherents = "SELECT * FROM adherents ORDER BY nom"; 
SrsListeAdherents = mysql_query($query_rsListeAdherents, SconnexionSport) or 
die(mysql_error( ) ) ; 

6. Fermez cette premiere zone de script PHP en ajoutant la balise ?> puis descendez dans le code de 
la page et placez votre curseur sur la deuxieme ligne du tableau. 

7. Dans les deux premieres cellules de la seconde ligne, ajoutez deux inclusions PHP afin d'afficher 
le nom et le prenom de F adherent dans chacune des cellules (voir repere 2 de la figure 18-34). 
Dans la cellule suivante, ajoutez un lien hypertexte dont le parametre d'URL ID sera configure 
avec l'element du jeu d'enregistrements correspondant : 

<tr> 

<td><?php echo $row_rsLi steAdherents[ ' nom' ] ; ?></td> 
<td><?php echo $row_rsLi steAdherents[ ' prenom' ] ; ?></td> 
<td> 

<a href="adherentsGestion.php?action=suppression&ID=<?php echo $row_rsListeAdherents 
*['ID']; ?>">x</a> 
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</td> 

<td>x</td> 
</tr> 
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[liilcod* l^frjcttmmr |^Cr««Uon ^ litre : [PAGE GESTIOW 



t?>. 5t * 0 OH ^ 



I <body^ 

|<diw align>"cent«c" c Ims-" Style 1"> 

<p>PAGE DE GESTION DE LA TABLE adherents </p> 

<p><a hreC»"adherentsA3out.php">ajout d'un nouvel adhieacwte : tent </a></p> 

< table width«"5O0" bordec-"l" cellpadding-"0" cellspacing-***)" botdetcolof-1000000** 

<tc> 

fi <dlv align-"cencei"> 



while 



<tdxfpln? echo (io«_csLisceAdherenu[ 'noa' }; ?x/td> 
<td><?pip echo f io¥_t5tisteAdheren«[ 'preno»' ); ?X/td> 

<Cd><a hcef "*'adhei:entsGescion.php?action"Suppce33iontID"- >i>hji echo (co«_t3ListeAdhecent3[ ' ID ' ] ; ?>">x</a>< 
<td><a href ■"adherentsn'odif .php?ID-- >php echo Ciou_csLi3teAdheEents[ ' ID ' ]; ?>">x</a></cd> 



2BL 

table) 



</table> 
</div></td> 
</tr> 
</t«ble> 
<p>4ntap;</p> 



I </dlv> 
|</body> 
I </ht»l> 
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Figure 18-34 

Script insere dans la structure du tableau HTML de la page adherentsGestion.php 



8. Placez votre curseur au-dessus de la balise de cette deuxieme ligne <tr> et ajoutez le script de la 
boucle whi 1 e afin de generer autant de lignes qu'il y aura de resultats retournes dans le jeu d'enre- 
gistrements $row_rsLi steAdherents. Placez ensuite votre curseur en dessous de la balise de fin de 
cette ligne (</tr>) et ajoutez un deuxieme script afin d'indiquer, par la presence d'une accolade 
fermante, la fin du bloc a dupliquer (voir repere 1 de la figure 18-34). 

9. Enregistrez la page adherentsGestion.php. Ouvrez la page adherentsAjout.php afin d'ajouter un 
script qui permette de retourner automatiquement a la page de gestion des qu'un nouvel adherent 
est ajoute dans la table. Pour cela, placez votre curseur a la fin du bloc conditionne par l'expression 
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$action=="ajout" et ajoutez line instruction de redirection (header("Location:adherentsGes- 
ti on . php" )) a la fin du bloc (voir la ligne en gras dans le script ci-dessous). Enregistrez ensuite les 
modifications effectuees dans cette page : 

// TESTE SI ENVOI DEPUIS FORMULAIRE 

if($action=="ajout") { 

// REQUETE SQL 

$insertAdherents = "INSERT INTO adherents SET 
nom=' " . $nom. " ' , 
prenom= ' " . $prenom. " ' , 
anneeNai ssance=' " . SanneeNai ssance. " ' , 
coursID=".$coursID."" ; 

// SOUMISSION REQUETE 

mysql_query($insertAdherents, SconnexionSport) or die(mysql_error( ) ) ; 

// RETOUR A LA PAGE DE GESTION APRES L'AJOUT 

header ("Locati on :adherentsGesti on. php") ; 

} 

10. Passez dans le Web local (voir figure 18-35). Cliquez sur le lien d'ajout d'un nouvel adherent (au- 
dessus du tableau HTML) et saisissez les informations du formulaire afin de creer un adherent. 
Apres validation du formulaire d'ajout, vous devez etre redirige vers la page de gestion. Le 
nouvel adherent doit apparaitre dans la liste de la page de gestion de la table adherents. Cliquez 
sur le lien Supp. correspondant a ce nouvel adherent (voir figure 18-35) et assurez-vous qu'il 
disparait bien de la liste des adherents lors de Factualisation de la page adherentsGesti on .php. 
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Test de lafonction de suppression de la page adherentsGestion.php 
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Figure 18-36 

Schema de principe illustrant la suppression d'un enregistrement a partir du die sur un lien integre dans un tableau 
HTML 



Page de modification d'un enregistrement 

La troisieme page est destinee a modifier les enregistrements d'une table. La structure du formulaire 
utilise est identique a celle du formulaire de la page d'ajout, hormis le fait que chaque champ doit etre 
initialise avec la valeur de la colonne correspondante issue de la table et que la requete envoyee n'est 
pas une commande d'insertion (INSERT) mais une commande de modification (UPDATE). 

1. Pour eviter une saisie de code inutile, nous vous proposons d'ouvrir la page adherentsAjout.php 
et de Fenregistrer sous le nom adherentsModif . php. 

2 Passez en mode Creation et ajoutez un second champ masque nomme IDform (voir figure 18-37) 
a cote du premier champ masque dans le formulaire (utilisez le bouton Champ masque du panneau 
Formulaire de la barre d'outils Inserer). La valeur initiale de ce champ sera configuree dyna- 
miquement par la suite. Cliquez sur le champ masque acti on et remplacez sa valeur par modi f . 

3. Passez en mode Code et placez-vous en haut du code de la page. Ajoutez dans la page les deux lignes 
en gras du script ci-dessous (voir le repere 1 de la figure 18-38). La premiere ligne permet de recupe- 
rer la valeur de Fidentifiant ID envoyee dans FURL depuis la page d' administration (en methode GET) 
lorsque Futilisateur clique sur le lien Modif. La seconde ligne permet de recuperer ce meme identifiant 
lors de la soumission du formulaire de modification (methode POST depuis le champ cache IDform). 



A noter 

Pour eviter tout conflit entre ces deux variables, nous avons utilise un nom different pour chacune d'elles. 
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Figure 18-37 

Ajout du champ masque IDform dans le formulaire de modification d'un enregistrement 



La variable de cet identiflant est ensuite integree dans la clause WHERE de la requete de mise a 
jour afln de specifier 1' enregistrement qui doit etre modifie. 

// INITIALISATION DES VARIABLES 

// INFORMATION ENVOYEE PAR URL (GET) 

if(isset($_GET['ID'])) $ID=$_GET[ ' ID' ] ; else $ I D=0 ; 

// INFORMATION ENVOYEE PAR LE FORMULAIRE (POST) 

if(isset($_POST['nom'])) $nom=$_P0ST[ ' nom' ] ; else $nom=""; 

i f (i sset($_P0ST[ 'prenom' ] ) ) $prenom=$_POST[ ' prenom' ] ; else $prenom="" ; 

i f (i sset($_P0ST[ ' anneeNaissance' ] ) ) $anneeNaissance=$_POST[ ' anneeNaissance' ] ; 

*»else $anneeNaissance="" ; 

if(isset($_POST['coursID'])) Scours I D=$_P0ST[ ' coursID' ] ; else $coiirsID="" ; 
if(isset($_POST['action'])) $action=$_POST[ ' action '] ; else $action=""; 
if(isset($_POST['IDform'])) $IDform=$_POST[ ' IDform' ] ; else $IDform=0; 
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4. Les deux lignes destinees a etablir la connexion avec le serveur MySQL et a selectionner la base de 
donnees sont conservees a l'identique. II en est de meme pour la requete du jeu d'enregistrements 
$rsLi steCours utilisee pour afficher les differents niveaux de cours dans le menu deroulant Cours 
(voir le repere 2 de la figure 18-38) : 

// CONNEXION ET SELECTION DE LA BASE 

requi re_once( ' . . /Connect i on s/connexionSport . php ' ) ; 
mysql_sel ect_db( $database_connexionSport , SconnexionSport ) ; 

// RECUPERATION DES INFORMATIONS DE LA LISTE DEROULANTE "COURS" 

$query_rsLi steCours = "SELECT * FROM cours ORDER BY ID"; 

$rsLi steCours = mysql_query($query_rsListeCours , SconnexionSport) or 

*»die(mysql_error( ) ) ; 
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rsLlsteCours ■ »Y3ql_q\iery(SqueEy_E3Li3teCour3, SconnexionSport) or dle(»ysql_error 
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;oursID*". (coursID. " 

WERE ID-".«n>£oni ; 

kysql_query (fupdateAdherents, SconnexionSport) or die (aysql_error () ) ; 



header ("Location: adheres tsGestion. php") ; 
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Figure 18-38 

Debut du script de la page adherentsModif.php 
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5. Sous ces lignes, la condition de la structure de choix est remplacee par $acti on=="modi f " (la varia- 
ble utilisee est issue du champ masque action du formulaire ; voir le repere 3 de la figure 18-38) 
afin de detecter si le formulaire de modification a bien ete envoye. De meme, la requete 
d'insertion est transformee en requete de mise a jour comme le montre le script ci-dessous. 
L'instruction de soumission doit etre adaptee au nouveau nom de la requete (soit 
SupdateAdherents ; voir repere 4 de la figure 18-38). Enfin, l'instruction de redirection apres 
l'envoi de la commande vers la page adherentsGestion.php est conservee a Fidentique (voir le 
repere 3 de la figure 18-38) : 

// TESTE SI ENVOI DEPUIS FORMULAIRE 

if($action=="modif ") { 



SupdateAdherents = "UPDATE adherents SET 

nom=' " . $nom. " ' , 

prenom= ' " . Sprenom. " ' , 

anneeNai ssance=' " . SanneeNai ssance. " ' , 

coursID=".$coursID." 

WHERE ID=".$IDform ; 

// SOUMISSION REQUETE 

mysql_query( SupdateAdherents , SconnexionSport) or die(mysql_error( ) ) ; 

// RETOUR A LA PAGE DE GESTION APRES L'AJOUT 

header ( "Location : adhe rent sGest ion .php" ) ; 



6. Ajoutez a la suite de la structure de choix les lignes de code suivantes afin de disposer du jeu 
d'enregistrements $rsListeAdherents. Celui-ci sera ensuite utilise pour initialiser les differents 
champs du formulaire : 



Squery^rsListeAdherents = "SELECT * FROM adherents WHERE ID=".$ID." ORDER BY ID"; 
SrsListeAdherents = mysql_query($query_rsListeAdherents, SconnexionSport) 
*»or die(mysql_error( ) ) ; 

$row_rsListeAdherents = mysql_fetch_assoc($rsListeAdherents); 

7. Descendez dans le code et placez votre curseur au niveau du formulaire de modification (voir 
les reperes 1, 2, 3, 4 et 5 correspondant aux cinq lignes du formulaire dans la figure 18-39). 
Inserez dans chaque balise de champ un attribut val ue dont la valeur est initialisee dynamique- 
ment a Faide du jeu d'enregistrements $row_rsListeAdherents (voir les zones en gras dans le 
script ci-dessous). L'initialisation du menu deroulant est particulier car il faut generer le mot-cle 
sel ected dans la balise option si la valeur de l'option correspond a celle qui est memorisee dans 
la base de donnees (voir le repere 4 de la figure 18-39) : 



// 



REQUETE SQL 



// 



RECUPERATION DES VALEURS INITIALES DES CHAMPS 



<form action="adherentsModif .php" method="post" name="forml"> 

<table width="500" border="l" cellpadding="0" eel 1 spacing="0" bordercol or="#000000"> 
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<tr><td><div al i gn="center"> 

<table width="500" border="0" eel 1 spacing="0" cellpadding="5"> 

<tr><td width="250"Xdiv align="right"Xspan cl ass="Styl e4">Nom : </span></div></td> 

<td width="250"Xdiv a!1gn="left"> 

<input name="nom" type="text" id="nom" 

value="<?php echo $row_rsLi steAdherents[ 'nom' ] ; ?>"> 

</divX/tdX/tr> 

<tr><tdXdiv align="right"Xspan cl ass="Styl e4">Pr&eacute ;nom : </spanX/di vX/td> 
<td><d1v align="left"> 

<input name="prenom" type="text" id="prenom" 
value="<?php echo $row_rsLi steAdherents[ 'prenom' ] ; ?>"> 
</div></td></tr> 

<tr><tdXdiv al ign="right"Xspan class="Style4">Année de naissance : </span></ 
divX/td> 

<td><d1v align="left"> 

<input name="anneeNai ssance" type="text" id="anneeNaissance" size="4" maxl ength="4" 

value="<?php echo $row_rsLi steAdherents[ ' anneeNai ssance' ] ; ?>"> 

</divX/tdX/tr> 

<trXtd><div al ign="right"Xspan cl ass="Styl e4">Cours : </spanX/divX/td> 

<td><d1v align="left"> 

<select name="coursID" id="coursID"> 

<?php while($row_rsListeCours = mysql_fetch_assoc($rsl_isteCours)) { ?> 
<option val ue="<?php echo $row_rsListeCours['ID']; ?>" 

<?php i f ($row_rsl_i steCours[ ' ID' ]==$row_rsListeAdherents[ ' coursID' ] ) echo "selected"; 

?> > 

<?php echo $row_rsListeCours[ ' ni veau' ] ; ?X/option> 

<?php } ?> 

</select> 

</divX/tdX/tr> 

<trXtd><div align="right"Xspan cl ass="Styl e4"> 

<input name="IDform" type="hidden" id="IDform" 

value="<?php echo $row_rsLi steAdherents[ ' ID' ] ; ?>"> 

<input name="action" type="hidden" id="action" val ue="modi f "> 

</spanX/d1vX/td> 

<td><div align="left"> 

<input type="submit" name="Submit" val ue="Envoyer"> 

</divX/tdX/tr> 

</table> 

</divX/tdX/tr> 

</table> 

</form> 
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Figure 18-39 

Code source du formulaire de modification 



8. Enregistrez la page et passez dans le Web local. Affichez la page adherentsGestion.php puis 
cliquez sur un lien de la colonne Modif. Le formulaire de modification s'affiche. Ses champs 
sont initialises selon les valeurs actuellement memorisees dans la base de donnees (voir 
figure 18-40). Modifiez le champ de votre choix et cliquez sur le bouton de validation. Apres 
l'envoi de la requete, vous devez etre redirige vers la page adherentsGestion.php. Cliquez de 
nouveau sur le lien Modif. du meme adherent pour vous assurer que la modification a bien ete 
effectuee. 
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Figure 18-40 

Schema de principe du fonctionnement du systeme de modification d'un enregistrement 



Modification dynamique d'un fichier (option) 

Dans le formulaire d'ajout, nous vous avons propose d'integrer un champ photo dans la table arm de 
memoriser le fichier de la photo de 1' adherent. Voici les modifications a apporter a votre formulaire 
de modification si vous souhaitez modifier ce fichier. Nous supposons que la structure de la base de 
donnees a deja ete modifiee et que le champ photo est present dans la table adherents. 

1. Comme dans le formulaire d'ajout, il faut ajouter une structure de choix afin d'enregistrer le 
fichier sur le serveur uniquement si un nouveau fichier photo est selectionne par l'utilisateur : 

if ($action=="modif ") { 

if ( $_FILES[' photo' ][ 'name' ]!="") 
{ 

$nomphoto='photo_' . $nom. ' . jpg' ; 

copy ($_FI LES [ 'photo' ] [ ' tmp_name ' ] , ' . . /photos/ ' . Inomphoto) ; 

} 

2. Modifiez ensuite de la meme maniere la requete SQL afin de mettre a jour le champ photo 
uniquement si un fichier photo est selectionne par l'utilisateur : 

// REQUETE SQL 

SupdateAdherents = "UPDATE adherents SET 

nom= ' " . $nom. " ' , 

prenom= ' " . Sprenom. " ' , 

anneeNai ssance=' " . SanneeNai ssance. " ' , 
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coursID=".$coursID." "; 
if ($_FILES[' photo' ][' name' ]!="") 
{ 

SupdateAdherents . = ", photo=' " . Snomphoto. ; 

} 

SupdateAdherents .=" WHERE ID=" . SIDform ; 

Ajoutez un champ de fichier nomme photo dans le formulaire de modification : 

<input name="photo" type="file" id="photo"> 

Contrairement aux autres champs qui rappellent dans l'element du formulaire la valeur actuelle 
de la variable concernee (a Faide de l'attribut value=, par exemple, pour un element INPUT de 
type text), l'objet « champ de fichier » (element INPUT de type file) ne peut pas etre initialise 
avec une valeur par defaut. Cependant, vous pouvez rappeler la photo actuellement memorisee 
dans la base en Faffichant sous le champ a l'aide du code suivant : 

<img src=". ./photos/<?php echo $row_rsl_isteAdherents[ 'photo' ] ; ?>" > 

Enregistrez puis testez votre formulaire depuis le Web local. 
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Figure 18-41 

Page de modification d'un enregistrement de la base adherents avec gestlon d'une photo 
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Structure d'un espace d'administration multitable 

Vous disposez desormais de scripts pour gerer l'ajout, la suppression et la modification d'un enregis- 
trement dans une table. Cependant, en pratique il vous faut creer des espaces d'administration afin de 
gerer plusieurs tables de la base de donnees. Un espace d'administration est evolutif (ajout ou 
suppression d'une table, par exemple) ; il est done judicieux de creer des pages d'administration dont 
le menu transversal (qui permet d'acceder a chaque formulaire de gestion d'une table) pourra etre 
actualise simplement et rapidement. 

Pour realiser ces pages d'administration, vous pouvez soit creer avec Dreamweaver un modele de 
page d'administration comportant une barre de navigation (menu transversal permettant d'acceder 
aux pages de gestion de chaque table), soit integrer dynamiquement cette barre de navigation dans 
toutes les pages a l'aide d'une instruction incl ude(). 

Creation d'un modele de page d'administration 

Cette premiere solution consiste a creer avec Dreamweaver une page modele dans laquelle sera integre 
un menu dont les differents liens permettent d'acceder a chaque page de gestion de table. 

Si vous utilisez ce modele pour creer toutes les pages de 1' espace d'administration, lorsque vous 
modifiez son menu et y ajoutez un nouveau lien, toutes les pages issues du meme modele seront auto- 
matiquement actualisees. 

Pour illustrer ce principe, nous vous proposons de creer une page modele destinee a gerer 
les tables adherents et professeurs. Par la suite, vous pourrez transposer la structure de ce modele 
en l'adaptant a la base de donnees de voire futur projet et gerer autant de table que vous le 
souhaitez : 

1. Ouvrez une nouvelle page dynamique dans Dreamweaver. Creez un tableau d'une ligne et de 
deux colonnes. Saisissez les noms des tables a gerer dans les cellules du tableau. Convertissez 
ces noms en liens hypertextes afin qu'ils appellent respectivement les pages de gestion de chaque 
table (soit dans notre exemple : adherentsGestion.php et professeursGestion.php). 

2. Creez un autre tableau d'une seule cellule en dessous. Selectionnez ce nouveau tableau et para- 
metrez sa largeur et sa hauteur a 100 % afin qu'il s'affiche en plein page. 

3. Assurez-vous que le tableau est toujours selectionne et deroulez le menu Insertion>Objets 
modele>Region modifiable. Validez puis donnez le nom de votre choix a cette zone modifiable 
dans la boite de dialogue Nouvelle region modifiable. 

4. Enregistrez cette page comme modele (menu Fichier>Enregistrez comme modele). 

5. Creez ensuite dans le meme repertoire /administration/ toutes les pages de gestion des tables 
adherents et professeurs a partir de ce meme modele (menu Nouveau, onglet Modele, selectionnez 
le site Sport puis le modele precedemment cree). 
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Figure 18-42 

Creation d'une region modifiable pour lefutur modele de la page d' administration. 



6. Votre espace d' administration dispose des six pages suivantes, qui vous permettent d'administrer 
les enregistrements des deux tables de Fexemple : 

- adherentsGestion.php 

- adherentsAjout.php 

- adherentsModif .php 

- professeursGestion.php 

- prof esseursAjout. php 

- professeursModif .php 

7. Par la suite, si vous desirez modifier la barre de navigation (arm de pouvoir gerer une nouvelle 
table, par exemple), il vous suffit d'ouvrir et de modifier le modele d' administration (dans Dream- 
weaver, les modeles sont regroupes dans un repertoire /Tempi ates/ place a la racine du site). Lors 
de Fenregistrement du modele, une boite de dialogue vous demande si vous desirez mettre a jour 
tous les documents issus du modele. Si vous acceptez, la barre de navigation de toutes les pages de 
F espace d' administration sera actualisee automatiquement. 
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Figure 18-43 

Page de gestion de la table adherents creee a partir du modele d' administration 



Gestion de la table adherents 



Ajout d'un nouvel/adherent 





Q -J / 












Suppression 
d'un adherent 



Modification d'un adherent 




Figure 18-44 

Organisation des pages de gestion de la table adherents 
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Integration dynamique du menu d'administration 

La seconde solution pour integrer dynamiquement un menu transversal dans chaque page de l'espace 
d'administration consiste a utiliser 1'instruction incl ude(). Pour illustrer cette methode, reprenons le 
meme exemple que ci-dessus (deux tables a gerer) : 

1 . Un premier fichier contenant le menu doit d' abord etre cree (fichier men uAdmi n . php) : 

<table width="700" border="0" al ign="center" eel 1 paddi ng="0" cellspacing="0"> 

<tr><td width="350"Xdiv al ign="center" cl ass="Styl e3"> 
<a href="adherentsGestion.php">Gestion table des adhérents </a> 
</div></td><td width="350"Xdiv al ign="center" class="Style3"> 
<a href="professeursGestion.php">Gestion table des professeurs </a> 
</divX/tdX/tr> 
</table> 

2. Ensuite, chaque page d'administration doit comporter une instruction includeO arm d'inserer 
tout le code du menu dans le haut des pages (apres la balise <body>, par exemple) comme le 
montre le fragment de code ci-dessous. Ainsi, si vous desirez ajouter un lien supplemental au 
menu, il vous suffit de modifier le code du fichier menuAdmin.php et le nouveau menu s'actualise 
automatiquement dans toutes les pages comportant 1'instruction incl ude( ) presentee ci-dessus : 

<body> 

<?php incl ude( "menuAdmin .php" ) ; ?> 



Gestion des erreurs MySQL 

PHP met a votre disposition la fonction mysql_error( ), qui retourne le type d'erreur sous forme de 
chame (s'il y en une, sinon la fonction retourne une chaine vide) et la fonction mysql_errrorno( ), qui 
retourne le numero de l'erreur (s'il y en a une, sinon la fonction retourne la valeur 0). Pour utiliser ces 
deux fonctions, vous pouvez passer l'identificateur de connexion au serveur MySQL en argument de 
ces deux fonctions. Si vous utilisez ces fonctions sans argument, e'est la derniere connexion active 
qui sera utilisee. 

Lors de la soumission d'une requete, il suffit de lier l'une de ces deux fonctions a 1'instruction 
mysql_query( ) a l'aide d'une fonction or die() ou or trigger_error( ) pour afficher un message 
d'erreur explicite en cas de refus de la requete SQL : 

mysql_query($updateAdherents, SconnexionSport) or die(mysql_error( ) ) ; 

En phase de developpement, ces messages vous seront precieux pour deboguer vos scripts. Cepen- 
dant, si votre application passe en production, il faudra controler ces erreurs et eviter l'affichage de 
ces messages peu esthetiques. PHP vous permet de neutraliser l'affichage des messages d'erreur 
grace a l'ajout du caractere @ devant la fonction : 

@mysql_query($updateAdherents , SconnexionSport) 
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Rappelons que la fonction mysql_query( ) renvoie un pointeur de resultat (qui doit ensuite etre inter- 
prete a Faide d'une fonction comme mysql_fetch_assoc( )) dans le cas d'une commande SELECT. Pour 
les autres commandes SQL comme DELETE, INSERT, UPDATE, la fonction renvoie une valeur TRUE en 
cas de succes ou une valeur FALSE en cas de probleme. II peut etre interessant de recuperer cette 
valeur afin de traiter Ferreur : 

$res=mysql_query($updateAdherents , $connexionSport) 
if(!$res) { 

echo "ERREUR MYSQL" .mysql_error( ). " N' ". mysql_errorno( ) ; 
} 

De meme, il est interessant d' exploiter cette structure pour rediriger le visiteur vers un message plus 
rassurant et adapte a la charte graphique du site en cas de probleme comme le montre ce deuxieme 
exemple (vous remarquerez que la fonction est precedee du caractere @ afin de neutraliser l'affichage 
du message d'erreur genere par defaut) : 

$res=@mysql_query($updateAdherents , SconnexionSport) 
if(!$res) { 

header ( "Location :erreurMysql . php" ) ; 
} 

Des erreurs peuvent aussi etre generees par la fonction mysql_connect( ) si la connexion au serveur 
MySQL est impossible. Si vous desirez controler les messages et rediriger le visiteur vers une page 
adaptee, modifiez la fonction mysql_connect( ) dans le fichier connexionSport.php comme indique ci- 
dessous (suppression de l'affichage du type d'eiTeur et ajout d'un @ devant la fonction) : 

SconnexionSport = @mysql_connect($hostname_connexionSport, $username_connexionSport. 
*»$password_connexionSport) ; 

II faudra evidemment integrer un test au debut de chaque page utilisant cette fonction comme l'illustre 
le script ci-dessous : 

requi re_once( ' . ./Connections/connexionSport.php' ); 

if ( !$connexionSport) { 

header ( "Location :erreurMysql .php" ) ; 

} 



Interfagage Flash-MySQL 

L'interfacage Flash-MySQL permet a une application Flash d'enregistrer ou d' exploiter des informa- 
tions provenant d'une base de donnees MySQL. Une application Flash ne peut pas interagir directe- 
ment sur une base de donnees MySQL. II faut done utiliser des scripts PHP adaptes afin de realiser 
une passerelle entre Flash et MySQL. En pratique, l'interfacage Flash-MySQL est constitue d'une 
interface Flash-PHP couplee a une interface PHP -MySQL (voir figure 18-45). Comme nous venons 
de presenter les solutions d'interfacage PHP-MySQL et que l'interfacage entre une application Flash 
et un script PHP a ete presente dans le chapitre 11, nous allons maintenant etudier 1' exploitation 
conjointe de ces deux types d'interfa§age dans le cadre d'une application concrete de controle 
d'acces par mot de passe. 
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Figure 18-45 
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Controle d'acces par mot de passe 

Cette application Flash dynamique permet de controler 1'acces d'un utilisateur a des pages protegees 
(pageProtegeel . php et pageProtegee2.php). La page d'acces est constitute d'un formulaire Flash qui 
invite l'utilisateur a saisir son login et son mot de passe. Sur cette meme page, un lien permet a l'utili- 
sateur d'afficher un second formulaire lui permettant de s'inscrire. Les informations recueillies lors de 
l'inscription sont memorisees dans une base de donnees via un script PHP adapte (i nscri pti on . php). 



Figure 18-46 
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2 - passage sur le 
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La procedure d' authentication est elle aussi assuree par un script PHP (authenti f i cati on .php) qui a 
pour fonction de recuperer les parametres de connexion fournis par l'utilisateur et d'interroger la 
base de donnees afin de verifier la presence et la concordance du login et du mot de passe fournis. 
Si la reponse de la base est positive, l'utilisateur est dirige automatiquement vers la premiere page 
protegee (voir figure 18-46). Dans le cas contraire, un message d'erreur l'invite a renouveler sa saisie 
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apres avoir verifie l'exactitude de ses parametres. Si un utilisateur tente d'acceder directement aux 
pages protegees, il sera redirige automatiquement vers le formulaire d'authentification car chaque 
page protegee comporte un script qui teste Fauthentification de F utilisateur (grace a F inclusion du 
code contenu dans le fichier control e.php). 

Ce projet comporte un document Flash (formulaireLogin.fi a), une base de donnees MySQL 
nommee 1 ogi n_db (constituee d'une seule table uti 1 i sateurs) et plusieurs scripts PHP afin d'assurer 
les interactions entre F application Flash et la base de donnees ainsi que la memorisation de Fauthen- 
tification d'un utilisateur durant la session. 

La base de donnees 

Les parametres de chaque utilisateur sont memorises dans la base de donnees. II faut done commen- 
cer le developpement en creant la base et sa table. Pour cela, ouvrez le gestionnaire phpMyAdmin 
(deroulez le menu du manager de Wamp 5 puis selectionnez phpMyAdmin). Une fois le gestionnaire 
ouvert, saisissez le nom de la nouvelle base dans le champ de droite (voir figure 18-47) et validez en 
cliquant sur le bouton Creer. 
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Figure 18-47 

Creation de la nouvelle base de donnees login_db 



Une fois la base creee, deux solutions s'offrent a vous pour construire la structure de la table : vous 
pouvez soit suivre les etapes de creation avec le gestionnaire (ces etapes sont detaillees ci-dessous, 
voir figure 18-49), soit utiliser les instructions de restauration SQL que vous trouverez dans le 
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dossier /archives/sql / du projet SITElogin (disponible en telechargement sur le site www.editions- 
eyrolles.com). Ce fichier, nomme login_db.sql, doit etre appele depuis le champ Emplacement du 
fichier texte de l'onglet Importer du gestionnaire (voir figure 18-48). Apres validation grace au 
bouton Executer, le fichier est telecharge sur le serveur et la base de donnees est restauree automa- 
tiquement. 
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Figure 18-48 

Chargement du fichier de sauvegarde de la base de donnees (login_db.sql) 
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Voici les differentes instructions SQL contenues dans le fichier de restauration login_db.sql qui 
permettent de creer la structure de la table utilisateurs et d'y inserer un premier enregistrement 
(login=defrance et secret=1234) : 

DROP TABLE IF EXISTS " uti 1 i sateurs " ; 
CREATE TABLE * uti 1 i sateurs " ( 

'ID' small int(6) NOT NULL auto_increment, 

"login" varchar(20) NOT NULL default ", 

'secret' varchar(20) NOT NULL default ", 

PRIMARY KEY ('ID') 
) TYPE=MyISAM AUT0_INCREMENT=2 ; 

INSERT INTO 'utilisateurs' VALUES (1, 'defrance', '1234'); 
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Voici les etapes a suivre si vous desirez constmire la table utilisateurs vous-meme a l'aide du 
gestionnaire phpMy Admin : 

1. Saisissez le nom de la table a creer (soit util isateurs) dans le champ Creer une nouvelle table et 
indiquez qu'elle comportera trois champs puis validez. 

2. Dans le formulaire de configuration des champs de la table (voir figure 18-49), saisissez ID et 
selectionnez SMALLINT pour le premier champ. A droite sur la meme ligne, selectionnez l'option 
auto_i increment dans la colonne Extra et cochez la case Primaire. 

3. Pour les deux autres champs, saisissez les noms login et secret. Selectionnez VARCHAR pour leur 
type et 20 pour leur taille. Cliquez ensuite sur Sauvegarder pour confirmer vos choix et creer la 
table. 
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Figure 18-49 

Creation de la table utilisateurs a I 'aide du gestionnaire phpMyAdmin 



Interfacage Flash-PHP-MySQL 



507 



Chapitre 18 

Votre table est desormais creee. Vous pouvez maintenant commencer a developper vos scripts PHP. 



A noter 

Actuellement, la table est vide mais cela n'est pas genant car vous pourrez bientot ajouter des enregistrements 
depuis le formulaire d'inscription. D'autre part, nous n'avons pas cree de user specifique pour acceder a cette 
table car nous utiliserons le compte root par defaut (sans mot de passe) pour nos tests en local. Cependant, si 
vous devez mettre cette application en ligne, il vous faudra creer et configurer un compte user avec son mot de 
passe (revoir si besoin la figure 16-30 et les commentaires correspondants). 



Les fichiers PHP 

Nous devons d'abord creer deux scripts PHP (authentification.php et inscription.php) qui servi- 
ront de passerelle entre la base de donnees que nous venons de creer et 1' application Flash que nous 
developperons ci-dessous. Un troisieme script PHP, nomme control e.php, sera integre dans toutes 
les pages a proteger a l'aide d'une simple instruction requi re_once( ). 

Configuration d'un nouveau site dynamique 

Avant de creer les pages PHP, il faut ouvrir et configurer un nouveau site dans Dreamweaver. Comme 
pour les precedentes applications de ce chapitre, nous utiliserons un fichier de connexion a la base de 
donnees MySQL compatible avec l'usage des comportements serveur de Dreamweaver. La proce- 
dure de creation de ce fichier ayant deja etait presentee, nous n'en detaillerons pas toutes les etapes et 
vous invitons a vous reporter a la figure 18-2 et aux commentaires en rapport si necessaire. 

Configuration du site : 

1. Ouvrez Dreamweaver. Dans le menu, cliquez sur la rubrique Sites puis selectionnez Gerer les 
sites. 

2. Dans la boite de dialogue Gerer les sites, cliquez sur le bouton Nouveau. 

3. Dans la boite de dialogue Definition du site, cliquez sur Fonglet Avance s'il n'est pas deja selec- 
tionne. 

4. Cliquez sur la categorie Infos Locales et renseignez les champs suivants : 

- Nom du site : SITElogin. 

- Dossier racine : cliquez sur le petit dossier situe a droite du champ afin d' ouvrir Fexplorateur 
de fichier. Ensuite, creez puis selectionnez un nouveau dossier /SITE! ogi n/ place dans le reper- 
toire racine www de la suite Wamp 5. 

5. Cliquez sur la categorie Serveur d' evaluation et renseignez les champs suivants : 

- Modele de serveur : selectionnez PHP-MySQL dans le menu deroulant ; 

- Acces : selectionnez Local/Reseau dans le menu deroulant ; 

- Dossier du serveur d' evaluation : theoriquement, ce champ doit etre preconfigure avec le 
chemin menant au repertoire du site www/SITEl ogi n/ ; 

- Prefixe de l'URL : ajoutez SITElogin/ a la suite de http: //local host/._ 

6. Cliquez sur le bouton OK de la boite de dialogue puis sur le bouton Terminer de la boite de dialogue 
Gerer les sites. 
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Creation du fichier de connexion : 

1 . Ouvrez une page PHP dans Dreamweaver (menu Fichier>Nouveau, selectionnez Page dynamique et 
PHP puis cliquez sur Creer). 

2. Deroulez le panneau Application et selectionnez Fonglet Base de donnees. 

3. Cliquez sur le bouton + et selectionnez la rubrique Connexion MySQL qui s'affiche dans le menu 
contextuel. 

4. La fenetre Connexion MySQL s'affiche. 

5. Saisissez un nom pour la connexion que vous allez creer. Ce nom doit etre explicite et ne pas 
comporter d'espace. Dans le cadre de notre application, nous utiliserons connexion Login. 

6. Dans le champ Serveur MySQL, saisissez 1 ocal host. 

7. Saisissez ensuite les parametres de Futilisateur root (utilisateur par defaut), soit nom 
d'utilisateur = root sans mot de passe. 

8. Cliquez sur le bouton Selectionner pour afficher toutes les bases de donnees disponibles. Selec- 
tionnez la base 1 ogi n_db et validez en cliquant sur le bouton OK. 

9. La base selectionnee doit etre affichee dans le champ Base de donnees. Vous pouvez maintenant 
verifier si la connexion est valide en cliquant sur le bouton Tester. 

10. Fermez la fenetre du message et confirmez la creation de la connexion en cliquant sur le bouton 
OK. 

1 1. La connexion a la base de donnees est desormais etablie. Une icone representant la base 1 ogi n_db 
apparait dans la fenetre Base de donnees. 

Si vous desirez creer manuellement le fichier de connexion a la base, saisissez les lignes de code 
suivantes dans votre editeur et enregistrez-les sous le nom connexionLogin.php dans le repertoire 
SITElogin/Connection/ : 

<?php 

$hostname_connexionLogin = "localhost"; 
$database_connexionLogin = "login_db"; 
$username_connexionLogin = "root"; 
$password_connexionLogin = ""; 

SconnexionLogin = mysql_connect($hostname_connexionLogin, $username_connexionLogin, 

*»$password_connexionLogin) or trigger_error(mysql_error( ) , E_USER_ERR0R) ; 

?> 

Creation de la page d'authentification 

La page authenti f i cati on . php a pour fonction de recuperer le login et le mot de passe envoyes par le 
formulaire de login de Flash, de construire une requete SQL afin d'interroger la base sur Fexistence 
et la concordance de ces parametres, de receptionner la reponse de la base et de la mettre en forme 
avant de la retourner a l'application Flash. Si la reponse est positive, le login de Futilisateur est 
memorise tant qu'il visite des pages protegees. 

1. Ouvrez un nouveau document dynamique PHP et enregistrez-le sous le nom authentifi- 
cation.php a la racine du site (repertoire /SITElogin/). 
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2. Saisissez une balise ouvrante PHP puis la fonction session_start( ) afin d'activer Fusage des 
sessions dans cette page (voir figure 18-50) : 

I <?php 

// Active les sessions 
I session_start( ) ; 

3. Saisissez deux lignes d' instruction destinees a recuperer (et a convertir au bon format si elles 
existent) les variables 1 ogi n et secret envoyees par l'application Flash : 

// Recuperation des variables envoyees par Flash 

if(isset($_POST['login'])) $login= utf8_decode($_P0ST[ ' 1 ogin ' ] ) ; else $login="inconnu" ; 
if(isset($_POST['secret'])) $secret= utf 8_decode($_P0ST[ ' secret']) ; else 
t $secret="inconnu" ; 

4. Declarez la fonction destinee a mettre en forme les variables retournees a l'application Flash : 

// F0NCTI0NS 

function envoi($var, $val){ 

echo "&".$var."=".utf8_encode($val ); 



5. Saisissez les deux lignes suivantes arm d'etablir une connexion a la base de donnees (appel du 
fichier de connexion cree precedemment) et de selectionner la base concernee : 



requi re_once( ' Connect ions/connexi on Logi n. php' ) ; 
mysql_select_db($database_connexionLogin, $connexi on Login) ; 

6. Creez et envoyez la requete SQL a la base de donnees. La clause WHERE de cette requete est 
personnalisee avec la variable login envoyee par le formulaire Flash. Le jeu d'enregistrements 
retourne par la requete (valeur du champ secret correspondant au login) est ensuite converti en 
tableau associatif avec la fonction mysql_fetch_assoc( ). La derniere ligne permet de connaitre le 
nombre d'enregistrements retournes dans le resultat (afin de detecter si le login n'existe pas) : 

// RECUPERATION DES INFORMATIONS (depuis la table adherents) 

$query_rsVerif Login = "SELECT secret FROM utilisateurs WHERE 1 ogi n='$l ogin' "; 
SrsVerif Login = mysql_query($query_rsVerif Login, SconnexionLogin) or die(mysql_error( )) ; 
$row_rsVerifLogin = mysql_fetch_assoc($rsVerifLogin) ; 
$total_rsVerif Logi n=mysql_num_rows($rsVerif Login) ; 

7. Une structure de choix if conditionnee par l'existence et la concordance du login et du mot de 
passe permet de retourner le couple retour=ok a l'application Flash puis de memoriser la valeur 
du login dans la session si le test est positif. Dans le cas contraire, le couple retour=pb est envoye 
a l'application Flash : 

/ TEST DE L'EXISTENCE ET DE CONCORDANCE LOGIN/PWD 

if(($secret == $row_rsVerif Login[ ' secret ' ] )&&($total_rsVerif Logi n!=0)){ 
//test si le controle du mot de passe est ok 
$_SESSION['login']=$login; 

//memorise le login de 1 'utilisateur en session 
envoi ( "retour" , "ok" ) ; 



// 
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//envoie la confirmation de 1 'authentifi cation a 1 'application Flash 

} 

el se 
{ 

envoi ( "retour" , "pb" ) ; 

//dans le cas contraire, un message d'erreur est renvoye a 1 'application Flash 

} 

8. Enregistrez votre fichier sous le nom authentification.php. 
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I require_once( 'blocageCache.php' ) ; 

I session_start(); 

:6cuperation des vaziables envoyees pax Flash 
I i£(isset((_PQST[ 'login' )) ' (login- ut£8_decode((_P0ST[ 'login' J) ; else (logln*"inconnu"; 
I if "isset'J_P03T[ ' secret ' J)) (secret* ut£8_decode((_P0ST[ 'secret' ]" ; else (seCEet«"inconnu"; 



I function envoi((var, (val)( 

I echo '*4".(v»x."-".ut£8_encode((val) ; 



I requixe_once ( ' Connections/connexionLogin. php ' ) ; 

I Mysql_3elect_db((database_connexionLogin, (connexionLogin) ; 

I (queiy_rsVerl£Logln * "SELECT secret FR0H utllisateurs UHEPE logln»'(logln' "j 
I (rsVerif Login = ■ysgl_q>iery((guery_rsVeriCLogin, (connexionLogin) or die(»ysql_error () ) ; 
I (rov_rsVeri£Login » *ysql_fetch_ass©c((rsVeri£Login) ; 
| (total_rsVeri£Login-»ysql_nu»_rows((rsVeri£Logln( ; 

| it ( ((secret -- (rou_rsVerif Login[ 'secret' ))«£(( total_rsVeri£Login! -0) ) ( 

:est si le controle du sot de passe est ok 
| (_3ESSI0»[ 'login' ]-(login; 

le&orise le login de l'utilisateut en session 
I envoi ("retour'V'ok") ; 

1 //envoie la confirmation de 1 ' authentif ic&tian a 1 ' application Flash 
I ) 

| else 
]< 

I envoi ("retour" / "pb") ; 

/dans le cas contraire, un sessaqe d'erreur est renvove a 1'application Flash 
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Figure 18-50 

Debut du programme de la page authentification.php 



Creation de la page d'inscription 

La page inscription. php a pour fonction de recuperer le login et le mot de passe envoy es par le 
formulaire d'inscription de Flash et de construire la commande INSERT necessaire pour ajouter un 
nouvel utilisateur dans la base de donnees. Afin d'eviter les doublons lors de la creation de login, une 
premiere requete SELECT est envoyee a la base de donnees avant la commande INSERT afin de s'assurer 
que le login propose par Tutilisateur n'est pas deja attribue. Si le nombre d'enregistrements retourne 



Interfagage Flash-PHP-MySQL 

Chapitre 18 



par cette requete est nul, la clause INSERT est executee. Un message de confirmation d' inscription est 
alors envoye a l'application Flash (retour=ok). Dans le cas contraire, un message d'erreur est envoye a 
l'application Flash (retour=pb) afin d'inviter Futilisateur a renouveler son inscription avec un autre login. 

1. Ouvrez un nouveau document dynamique PHP et enregistrez-le sous le nom inscription.php a la 
racine du site (repertoire/SITElogin/). 

2. Saisissez une balise ouvrante PHP puis deux lignes d' instruction destinees a recuperer (et a 
convertir au bon format si elles existent) les variables login et secret envoyees par l'application 
Flash (voir figure 18-51) : 

// Recuperation des variables envoyees par Flash 

if(isset($_POST['login'])) $login= utf8_decode($_P0ST[ ' 1 ogin ' ] ) ; else $login="inconnu" ; 
if(isset($_POST[ 'secret' ])) $secret= utf8_decode($_P0ST[ ' secret ']) ; 
*»else $secret="inconnu" ; 

3. Declarez la fonction destinee a mettre en forme les variables retournees a l'application Flash : 

// FONCTIONS 

function envoi($var, $val){ 

echo "&" . $var . "=" . utf8_encode($val ) ; 

} 

4. Saisissez les deux lignes suivantes afin d'etablir une connexion a la base de donnees (appel du 
fichier de connexion cree precedemment) et de selectionner la base concernee : 

■ // CONNEXION ET SELECTION DE LA BASE 

I requi re_once( 'Connections/connexionLogin.php' ); 

mysql_select_db($database_connexionLogin, $connexi on Login) ; 

5. Creez et envoyez une premiere requete SQL a la base de donnees. La clause WHERE de cette 
requete est personnalisee avec la variable login envoyee par le formulaire Flash. La fonction 
mysql_num_rows( ) permet de connaitre le nombre d'enregistrements retournes (la variable 
StotalVerif Login memorise ce nombre) : 

// VERIFIE SI LE LOGIN EXISTE DEjA (depuis la table adherents) 

$query_rsVerif Login = "SELECT secret FROM utilisateurs WHERE login='$login' "; 
SrsVerif Login = mysql_query($query_rsVerif Login, SconnexionLogin) or die(mysql_error( )) ; 
$totalVerifLogin=mysql _num_rows($rsVerif Login) ; // Recup du nombre total de resultat 

6. Une structure de choix if conditionnee par l'egalite de la variable StotalVerif Login avec 0 
permet d'executer la commande INSERT (insertion du login et du mot de passe du nouvel utilisa- 
teur dans la base) puis de retourner le couple retour=ok a l'application Flash si le test est positif. 
Dans le cas contraire, le couple retour=pb est envoye a l'application Flash : 

if($totalVerifLogin==0) { 

$insertInscription="INSERT INTO utilisateurs (login, secret) VALUES ( ' $login ' , 'Ssecret' )" ; 
mysql_query($insertInscription, SconnexionLogin) or di e(mysql_error( ) ) ; 
envoi("retour","ok"); 
}el se{ 

envoi ( "retour" , "pb" ) ; 
} 



Base de donnees MySQL 

Partie V 



Macromedia Dreamweaver MX 2004 - [SITEIogin/inscription.php] 



FtchJer Edition Affichaoe Insertion Modfef Texte Cwwnandes Ste Fenetre Aide 
Common - 1 E 4 1^ B; . . -j? G} ' E] . 



\ijCode 



nscrption.php 
i Fractwnner : Creation Titre 




<>^ fit ©. e H 



1 |c?i>hs> 

2 //recuperation des variables envoyees par Flash 

3 if(l3set((_P05T[ 1 login' ]) ) (login- utf8_decode(( POSTt ' login* ]) ; else Slogin-"inconnu"; 

4 if (lsset((_P03T[ 'secret' ]) ) (secret" utf8_deeode((_P0ST{ 'secret' J) ; else * secret*" inconnu", 

5 // rOKCTIOtfS 

6 (unction envoi ((var, (val){ 

7 echo "t".(var."-".utC8_encode((val); 

8 ) 

jb ft COIMEXI OH ET SELECT BASE 

10 tequire_once( 'Connections/connexiontogin.php'J; 

11 >.ysql_select_db(Sdatabase_connexlonlogin, (connexionLogin) ; 

12 // VERir 31 LOGIM EXI5TE DEJA (depuis la table adherents) 

13 (query_raVerl£Login ■ "SELECT secret FROH utiliseteurs WHERE login- '( login' 

14 (rsVenf Login • By3ql_query((queEy_csVerifLogin, (connexionLogin) or die (»ysql_etror () ) % 

15 (totalVerifLogln-»ysql_nu»_rovs((rsVerifLogin) ; i-cup dt 
& // 

1? if ((totalVerif Login-" ) { 

18 (lnsertlnscriptlon-'IHSERT IKTO utilisateurs (login, secret) VALUES ( '(login' , '(secret' )"; 

19 ftysql_queEy{(insettInscription, (connexionLogin) or die(ay3ql_erroc()); 

20 envoi {"retour",** ok") ; 

21 }else{ 

22 envoi("retour"/*pl>") ; 

23 ) 

24 ?> 
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Figure 18-51 

Programme de la page inscription.php 



Creation de la page de controle 

Le fichier control e.php est appele dans toutes les pages a proteger a Faide d'une fonction 
include_once( ) (exemple de code a inclure dans le debut de chaque page: <?php 
requi re_once( 'controle. php' ) ; ?>). Le script de ce fichier est constitute d'une fonction 
start_session( ) afin d'activer l'usage des sessions et d'une structure de test if conditionnee par 
l'existence de la variable de session 1 ogi n. Si la variable de session n'existe pas, le visiteur de la page 
protegee est redirige automatiquement vers la page du formulaire de connexion. Si la variable existe, 
la page protegee est affichee normalement. 

1. Ouvrez un nouveau document dynamique PHP. Enregistrez-le sous le nom control e.php a la 
racine du site (repertoire /SITEIogin/). 

2. Saisissez une balise ouvrante PHP puis la fonction session_start( ) afin d'activer l'usage des 
sessions dans cette page (voir figure 18-52) : 

<?php 

// Active les sessions 
session_start( ) ; 

3. Saisissez la structure de test if ci-dessous puis ajoutez une balise de fermeture PHP Si la 
variable de session login n'existe pas, l'instruction headerO est executee et le visiteur est 
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automatiquement redirige vers la page du formulaire de connexion. Dans le cas contraire, le reste 
de la page protegee dans laquelle est integre ce script est affiche normalement : 

if(!isset($_SESSION['login'])) 

{ 

header ( "Locati on: formul ai reLogin . html " ) ; 
} 

?> 
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2 3ession_3Coi:cO; 

3 i£(!i»set(S_SESSIOHriogin'])) 

4 ( 

5 header ("Location: f omulaiEeLogln. htal'") ; 

6 ) 

7 ?> 
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Programme du script controle.php 
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Le document Flash 

Le document Flash est organise en sept caiques (Label, Action, Bouton, Champ, Texte, Cadre et 
Fond). Le scenario est decoupe en deux zones. La premiere porte F etiquette Authentification, s'etend 
de l'image 1 a l'image 9 et regroupe les differents scripts et elements de l'ecran d' authentification. La 
seconde porte l'etiquette Inscription, s'etend de l'image 10 a l'image 19 et regroupe les differents 
scripts et elements de l'ecran d' inscription. 

1. Creez un nouveau document Flash et sauvegardez-le sous le nom formulaireL.ogin.fla dans le 
dossier www/SITEl ogin/ (le repertoire SITElogin a deja ete cree dans le repertoire racine www de 
Wamp 5). 

2. Creez sept caiques : Label, Action, Bouton, Champ, Texte, Cadre et Fond (voir figures 18-53 
et 18-54). 

3. Personnalisez le caique Fond en y ajoutant un fond gris qui delimitera la zone de 1' interface. 
Inserez une image cle dans l'image 20 du scenario. 

4. Dans l'image 1 du caique Label, saisissez le nom Authentification dans le champ image du 
panneau des proprietes. Inserez une image cle dans l'image 10 du scenario et saisissez le nom 
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Inscription dans le champ image du panneau des proprietes. Creez une derniere image cle dans 
F image 20. 

5. Dans 1' image 1 du caique Bouton, inserez deux boutons et nommez leurs occurrences respectives 
boutonl_btn (bouton OK) et bouton I l_btn (bouton Inscrivez-vous). Inserez une image cle dans 
l'image 10 du scenario et nommez les occurrences des boutons bouton2_btn (bouton OK) et 
boutonRl_btn (bouton Retour au login). 

6. Dans l'image 1 du caique Champs, ajoutez deux champs texte de saisie pour le login et le mot de 
passe. Nommez leurs occurrences log1n_txt et secret_txt. Selectionnez le champ secret_txt et 
configurez son type de ligne dans le panneau des proprietes en choisissant Mot de passe. Inserez 
une image cle dans l'image 20 du scenario. 
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2 // 
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5 > 

6 II 

7 bouconIl_btn.onRelea3e-functlon() { 

6 gotoAndScop("Inscclption") ; 



10 

11 // 

12 login_txt . text*"" 

13 secret txt.text"" 
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//efface le contenu du charm 
';//efface le contenu du chan 



H // 

15 function ver if icationLoginO ( 

16 if (login_txt.text I" "" ££ secret_txt.text 

17 authent if ication ( ) ; 
16 >else{ 

19 _root.nessage H "Attentlon, votce lc 

20 logln_txt.text B "";//effacei»ent du 

21 seccet_txt.text""";//ef facement di 

22 > 

23 >//fin de la fonction 

24 // 

25 function authent if ication () { 

26 var retour:String»""*;//variable de retour 
27 //creation des otnets LV 
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Figure 18-53 

Construction de l'image Authentification 



7. Dans 1' image 1 du caique Texte, ajoutez trois champs Texte statique pour le texte d' informa- 
tion situe en haut du cadre, ainsi que pour les libelles du login et du password. Inserez un 
Texte dynamique en bas du cadre et nommez son occurrence message_txt (voir figure 18-53). 
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Inserez ensuite une image cle dans l'image 10 du scenario. Modifiez le message du texte d'infor- 
mation (voir figure 18-54) puis inserez une autre image cle dans l'image 20. 
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1 stop(); 

a // 

3 bouton2_btn.onRelease-£unction() < 

4 venf icatlonInacnptlon() ; 

5 ) 

6 // 

7 boutonRl_btn.onReleaae"f unctlon() 1 
6 gotoAndStop ("Authent if lcation") ; 
9 ) 

10 // - 

11 logln_*txt.text"**";//er face le contenu du chamj 

12 secret_txt.text"";//ef<ace le contenu du chan 

13 mes3age_txt.text""";//ef face le contenu du cht 

M // 

15 function verlf lcatlonlnacrlptionfj ( 

16 If (logln_txt.text !- a secret_cxt . text 

17 inscription!) t 
16 )else{ 

19 _root.»eaaage"''Attention, votte lc 

20 login_txt.text-'"';//effacenient du 

21 aecret_txt . text"'"*; //et f acement di 

22 ) 

23 )//fin de la fonctlon 

24 // 

25 function inacr Ipt loaO : 

26 var re tour : String"'"*; //var table de retour 

2 7 //creation de a obieta LV v 
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Figure 18-54 

Construction de I 'image Inscription 



8. Dans l'image 1 du caique Cadre, ajoutez un cadre noir qui entoure les champs login et password 
(voir figure 18-53). Inserez une image cle dans l'image 10 du scenario. Modifiez la couleur interieure 
du cadre (orange, par exemple) puis inserez une autre image cle dans l'image 20 (voir figure 18-54). 

9. Dans l'image 1 du caique Action, ajoutez les deux methodes de gestionnaire en rapport avec les deux 
boutons boutonl_btn (bouton OK) et boutonIl_btn (bouton Inscrivez-vous). La premiere methode 
appelle la fonction verificationLoginO lors d'un clic sur le bouton OK. La seconde deplace la 
tete de lecture sur l'image Inscri pti on lors du clic sur le bouton Inscrivez-vous (voir figure 19-53). 

stop( ) ; 
// 

boutonl_btn.onRelease=function( ) { 
verif icationLogint ) ; 

} 
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II 

boutonIl_btn.onRelease=function( ) { 

gotoAndStop( "Inscri ption" ) ; 

} 

10. Ajoutez a la suite deux lignes de code afin d'effacer Feventuel contenu des deux champs de saisie : 
// 

login_txt.text=""; //efface le contenu du champ login 
secret_txt.text="" ;//efface le contenu du champ secret 

11. Saisissez la premiere fonction verificationLogin( ) appelee par le bouton OK. Cette fonction 
verifie si l'utilisateur a saisi au moins quatre caracteres dans chaque champ. Si le test est positif, 
la fonction authenti f i cati on ( ) est appelee. Sinon un message d'erreur s'affiche et le contenu des 
champs est efface : 

// 

function verificationl_ogin( ) { 

if (loginjxt.text != "" && secret_txt.text != "" && login_txt. text. length >=4 
secret_txt. text. length >=4){ 
authentificationt ) ; 

}el se{ 

_root.message="Attention, votre login et password doivent contenir au 
*moins quatre caracteres"; 
login_txt.text="" ;//effacement du champ login 
secret_txt.text="";//effacement du champ secret 

} 

}//fin de la fonction 

12. Saisissez la seconde fonction a la suite. Cette fonction est tres importante car c'est elle qui realise 
Finterfacage entre Fapplication Flash et le fichier authenti fi cati on. php. Pour cela, deux objets 
LoadVars doivent etre crees (monEnvoiJv et monChargementJ v). Les valeurs des champs 
login_txt et secret_txt sont ensuite affectees a des variables de cet objet monEnvoiJIv. Le 
gestionnaire d'evenements on Load detecte la fin du chargement des valeurs retournees par 
le script PHP dans l'objet monChargement_lv. II teste ensuite si la variable retour est egale a Ok. 
Si le test est positif, il affiche le message « Authentification verifiee » et redirige automatique- 
ment l'utilisateur vers la page protegee. Dans le cas contraire, il affiche un message d'erreur et 
invite l'utilisateur a verifier son login et son mot de passe. Enfin, la methode sendAndLoadt ) 
declenche l'appel et le chargement des variables entre Fapplication Flash (les objets LoadVars 
monEnvoi_l v et monChargement^l v) et le script PHP (authenti fi cation .php) : 

// 

function authentification( ) { 

var retour:String="";//variable de retour 

//creation des objets LV 

var monEnvoi_lv = new LoadVarsO; 

var monChargement_lv = new LoadVarsO; 

// Initialisation des variables de l'objet LV avec les valeurs saisies 
monEnvoi_l v. login = login_txt.text; 
monEnvoi„lv. secret = secret_txt.text; 
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II Detection du chargement 
monChargement„lv.onLoad = f unction(success) { 
if (success) { 

retour = monChargement_lv. retour; 
if (this.retour=="ok") { 

_root .message="Authenti f i cati on veri f i ee" ; 
getURLC'pageProtegee.php", "_self". "POST"); 

}el se{ 

_root.message="Acces refuse, verifiez votre login 
*-ou votre mot de passe"; 

} 

} else { 

_root. message = "Desole mais la verification n'a pas pu etre effectuee 
*»(pb technique)" ; 
} 

} // Fin du onLoad 

monEnvoi_lv.sendAndLoad("authentification.php", monChargement_l v , "POST"); 
}//fin de la fonction 

13. Placez-vous ensuite sur l'image cle 10 de ce meme caique et saisissez le code ci-dessous. Les 
premieres lignes de ce code permettent de gerer le bouton OK (appel de la fonction veri f 1 cati o- 
nlnscriptiont )) et le bouton Retour au Login qui deplace la tete de lecture sur l'image 1 
(F etiquette Authentication) (voir figure) : 

stop( ) ; 

// 

bouton2_btn.onRelease=function( ) { 

veri f i cationlnscriptiont ) ; 

} 

// 

bouton Rl_btn .on Rel ease=f unction ( ) { 

gotoAndStop( "Authentif i cation") ; 

} 

14. Ajoutez a la suite trois lignes de code afin d'effacer le contenu des deux champs de saisie et du 
champ de message dynamique : 

// 

login_txt.text="" ; // Efface le contenu du champ login 
secret_txt.text="" ; // Efface le contenu du champ secret 
message_txt.text=" " ; // Efface le contenu du champ message 

15. Saisissez la premiere fonction verificationlnscriptionO appelee par le bouton OK. Cette fonc- 
tion verifie si Futilisateur a saisi au moins quatre caracteres dans chaque champ. Si le test est 
positif, la fonction inscription( ) est appelee. Sinon un message d'erreur s'affiche et le contenu 
des champs est efface : 

7/ 

function verificationlnscriptionO { 

if (login_txt.text != "" && secret_txt.text != "" && login_txt. text. length >=4 
secret_txt. text. length >=4){ 
inscriptionO; 
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}el se{ 



_root.message="Attention , votre login et votre mot de passe doivent 
►comporter au moins quatre caracteres"; 

login_txt.text="" ; // Effacement du champ login 

secret_txt.text="" ; // Effacement du champ secret 



) 



} // Fin de la fonction 

16. Saissisez la seconde fonction a la suite. Comme dans la fonction authenti f i cati on ( ), deux objets 
LoadVars doivent etre crees (monlnscriptionj v et maReponse_l v). Les valeurs des champs 
loginjxt et secret_txt sont ensuite affectees a des variables de Fobjet monInscription_l v. Le 
gestionnaire d'evenement on Load detecte la fin du chargement des valeurs retournees par le script 
PHP dans Fobjet maReponseJ v. II teste ensuite si la variable retour est egale a OK .Si le test est 
positif, il affiche le message « Inscription effectuee » et place la tete de lecture sur l'image 
Authenti fi cati on afin que Futilisateur puisse se connecter avec son nouveau login. Dans le cas 
contraire, il affiche un message d'erreur qui indique que le login et le mot de passe doivent conte- 
nir au moins quatre caracteres. Enfin, la methode sendAndLoad( ) declenche l'appel et le charge- 
ment des variables entre l'application Flash (les objets LoadVars monlnscriptionjv et 
maReponse_lv) et le script PHP (inscription. php) : 



function inscription( ) { 

var retour :String="" ; //vari abl e de retour 

// Creation des objets LV 

var monInscription_l v = new LoadVarsO; 

var maReponse_lv = new LoadVarsO; 

// Initialisation des variables de 1'objet LV avec 

monInscription_l v. login = login_txt.text; 

monInscription_l v. secret = secret_txt.text; 

// Detection du chargement 

maReponse_lv.onLoad = function(success) { 



es valeurs saisies 



if (success) { 
retour 



= maReponse_l v . retour; 
i f (this . retour=="ok" ) { 

_root.message= 



mai ntenant 



'Inscription effectuee, vous pouvez 



*»vous authentifier" ; 
gotoAndStop( "Authenti fi cation" ) ; 

}el se{ 

_root .message="Attention le login existe deja, choisissez un 
*»autre login"; 
loginJxt.text=""; // Effacement du champ login 
secret_txt.text=""; // Effacement du champ secret 



} 

} else { 

_root. message = "Desole mais 
*»(pb technique)"; 
} 



'inscription n'a pas pu etre effectuee 



} // Fin du onLoad 
monInscription_lv.sendAndLoad(" inscription. php" , 

} 



maReponse_l v , "POST"); 



17. Enregistrez F animation et publiez-la sous le nom formul aireLogin.swf . 
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Simulation des pages protegees 

Afin de simuler le fonctionnement complet du systeme d'acces par mot de passe, il faut creer deux 
pages protegees. Pour ce faire, ouvrez deux animations Flash (pageProtegeel.fi a et 
pageProtegee2.fla) dans lesquelles sera integree une fonction getUrl ( ) qui permettra a l'utilisateur 
de passer d'une page protegee a l'autre (voir figure 18-55). Enregistrez puis publiez ces deux docu- 
ments dans des pages HTML. Ouvrez ces deux pages HTML depuis Dreamweaver et renommez-les 
en PHP. Au debut de chaque page, ajoutez l'instruction d'appel du fichier control e . php suivante (voir 
figure 18-56) : 

<?php 

// Controle de 1 'authentifi cation de l'utilisateur 

requi re_once( ' controle. php' ) ; 

?> 

Enregistrez ensuite les deux pages sous les noms pageProtegeel.php et pageProtegee2.php. 
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Figure 18-55 

Creation d'une page protegee pour tester le systeme d'acces par mot de passe 
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Figure 18-56 

Ajout de Vappelfichier controle.php dans le code d'une des pages protegees 



Test du systeme en Web local 

Une fois 1' animation Flash et les differents scripts PHP enregistres, il ne reste plus qu' a tester le fonc- 
tionnement de 1' ensemble depuis le Web local. Parcourez les differents repertoires pour acceder au 
repertoire SITElogin/ puis cliquez sur la page formulaireLogin.html. La fenetre de login s'affiche. 
Essayez de saisir un mot de passe quelconque (ou un login et un mot de passe de moins de quatre 
caracteres) afin de verifier que le controle fonctionne correctement et que le message indiquant que le 
login est incorrect s'affiche bien en bas du formulaire. Cliquez ensuite sur le lien Inscrivez-vous et 
saisissez votre nom et un mot de passe de votre choix dans le formulaire description (voir figure 18-57). 
Apres votre inscription, vous serez redirige vers l'ecran de login dans lequel vous saisirez vos 
nouveaux parametres (voir figure 18-58) et les validerez. Si le systeme de controle fonctionne correc- 
tement, vous devez etre redirige vers la premiere page protegee (voir figure 18-59). Vous pouvez 
cliquer sur le lien de la seconde page protegee pour vous assurer que votre login est bien memorise. 



Codes sources disponibles en ligne 

Tous les codes sources des applications presentees dans cet ouvrage sont disponibles sur Internet : 
www.edi tions-eyrol les .com (mots-cles : Fl ash PHP). 
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Figure 18-57 
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Figure 18-58 

Test du sy steme d'acces 
par mot de passe : 
ecran de login 



3 formuljirel op.in Microsoft Interne! I xploi 



4t) hltp:)f|«)snOogrirftniO«MI,og»i,l«H 



if** © 



Saisissez votre login et password 



login : 
password : 



defrance 



»i*t I iptlon flff ecftwe. VOU1 pO«M? 



Win .iiltl.. ill If I.- 1 



Figure 18-59 

Test du sy steme d'acces 
par mot de passe : 
page protegee 
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Introduction au XML 



Definition du XML 

XML est Facronyme de extensible Markup Language. Comme le HTML, le XML est une nornie 
SGML (Standard Generalized Markup Language) mais elle a ete developpee bien plus tard (en 1998 
alors que le HTML etait defini par le consortium W3C depuis 1990). 

Meme si Ton a tendance a le presenter comme le successeur du HTML, le XML se caracterise par le 
fait qu'il contient uniquement des donnees structurees, sans aucune indication quant a leur presen- 
tation. Ainsi, si vous ouvrez un document XML dans un navigateur, il n'affiche que la structure des 
donnees sous forme d'arborescence, contrairement au document HTML qui affiche la traditionnelle 
page Web car il contient a la fois les donnees et toutes les indications necessaires a leur mise en 
forme. 

XML est done particulierement bien adapte pour structurer, enregistrer et transmettre des donnees. 

Avantages du XML 

Les avantages du XML sont multiples. En voici quelques-uns qui devraient vous convaincre de son 
interet. 

• Simple - Comme son cousin le document HTML, le document XML est un simple document texte 
construit a partir de balises qui contiennent des informations. II est done lisible et interpretable par 
tous sans outil specifique et avec peu de connaissances prealables. 
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• Souple - L'utilisateur peut, s'il le desire, structurer les donnees et nommer librement chaque balise 
et attribut du document (contrairement au HTML pour lequel les noms des balises et des attributs 
sont predefinis). 

• Extensible - Le nombre de balises n'est pas limite (comme c'est le cas pour le HTML) et peut 
done etre etendu a volonte. 

• Independant - Grace a son contenu base sur un document texte et done universel, il peut etre 
utilise sur tout type de plate-forme (PC, Mac, Unix. . .) mais egalement avec tout type de langage de 
programmation (PHP, ASP. . .). 

• Interoperabilite - Le fait que le XML soit un langage universel favorise l'interoperabilite des 
applications et permet de realiser rapidement et simplement des echanges de donnees. 

• Gratuit - Le XML est developpe par le consortium W3C. Son utilisation est done libre et ne 
necessite pas l'achat d'une licence commerciale. 

Utilisations du XML avec Flash 
Pour le stockage de donnees 

Grace a sa structure, le document XML hierarchise et formate des donnees. Couple avec une applica- 
tion Flash, il permet de stacker des donnees complexes et favorise leur exploitation au sein de 1' appli- 
cation. De plus, ses elements sont descriptifs. Les donnees contenues par ces elements peuvent done 
etre presentees directement dans F application Flash. 

Pour le transfert de donnees 

Lors du developpement d' applications dynamiques, on est frequemment confronte a des proble- 
mes de transfert de donnees entre applications. II est toujours possible de creer des programmes 
pour convertir ces donnees d'un format en un autre, mais il est souvent plus judicieux d'exploiter 
un document XML pour assurer leur transfert (tout en preservant leur structure) entre ces deux 
applications. 

Pour facillter la maintenance d'un site 

Un document XML peut etre traite aussi facilement par une application Flash que par un script 
serveur PHP ; il est done interessant de regrouper les informations qui caracterisent un site dans 
un meme document XML. Ainsi, si un site est decline en version « tout Flash » et en HTML, la 
mise a jour des deux versions du site peut se reduire a l'actualisation du document XML 
commun. 
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Structure d un document XML 

Si vous avez deja utilise un document HTML, vous ne serez pas depayse face a un document 
XML. 

Lexemple ci-dessous permet de stocker d'une maniere structuree l'age des petits-enfants de 
plusieurs peres de famille (pour simplifier la representation, seuls les descendants masculins ont ete 
representes). 



element texte 

nodeValue ■ 
8 



=petitenfant> 



pronom= "Laurent' 



element texte 

nodeValue = 
5 



<petitenfant: cpetitenfant: =petitenfant= cpetitenfant= cpetitenfant^ 



X 



prenom="Julten" 



element texte 

nodeValue = 
12 



element texte 

nodeValue ' 
10 



prenom="Charles' 



element texte element texte 



nodeValue 1 
7 



nodeValue ■ 
3 



prenom»"Alex~ 



prenom-'Maxir 



X 



prenom="Fabton' 



«VALEURS DES ELEMENTS 
(ages des petits enfants) 



<enfant> 

prenom="Paul" 



<enfant> 

prenom="Alain" 



<enfant> 

prenom="Fabrice" 



<enfant> 

prenom="Nicolas" 



<pere> 

nom="Dupond" 
prenom="Jean" 



<pere> 

nom="Durand" 
prenom="Claude" 



<pere> 

nom="Duval" 
prenom="Thierry" 



<ages> 

(racine du document) 



Figure 19-1 

Structure d'un document XML 



Exemple de document XML : 

<?xml version="1.0" encoding="UTF-8"?> 

<!D0CTYPE info SYSTEM "http://adressedusite.com/info.dtd"> 
<ages> 

<pere prenom="Jean" nom="Dupond"> 

<enfant prenom="Paul "> 

<petitenfant prenom=" Laurent ">8</petitenfant> 
<peti tenf ant prenom="Jul ien">5</petitenfant> 
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</enfant> 

<enfant prenom="Alain"> 

<peti tenfant prenom="Charl es">12</petitenf ant> 
</enf ant> 

</pere> 

<pere prenom="Cl aude" nom="Durand"> 

<enfant prenom="Fabrice"> 

<peti tenfant prenom="Alex">10</peti tenf ant> 
<peti tenfant prenom="Maxime">7</peti tenfant> 
<peti tenf ant prenom="Fabien">3</peti tenfant> 

</enfant> 

</pere> 

<pere prenom="Thierry" nom="Duval "> 
<enfant prenom="Nicolas"> 

<peti tenfant /> 

<!--Nicolas n'apas d'enfant--> 
</enfant> 

</pere> 

</ages> 

L'en-tete 

Le document commence par un en-tete (facultatif) qui contient des informations sur la version de 
XML (version="1.0"), le jeu de caracteres utilise (encoding="UTF-8") et Fautonomie du document 
(standalone="no"). Dans l'en-tete, seule la version est obligatoire. Si aucun type de codage n'est 
defini, l'UTF-8 est utilise par defaut. 

<?xml version="1.0" encoding="UTF-8"? standal one="no" > 

L'en-tete peut aussi faire reference a une declaration du type de document (la DTD : Document Type 
Definition) qui permet de valider la conformite du document en se referant a l'URL d'un document 
en ligne ou en local (exemple : http://adressedusite.com/info.dtd). 

<!D0CTYPE info SYSTEM "http://adressedusite.com/info.dtd"> 

Si l'en-tete se refere a une DTD externe (comme c'est le cas dans l'exemple ci-dessus), le document 
n'est pas autonome et l'attribut standi one doit etre configure avec la valeur "no". Dans le cas 
contraire (s'il n'y a pas de DTD ou si elle est interne), le document est autonome et la valeur de 
l'attribut standalone doit etre definie a "yes". En cas d' absence de l'attribut standi one, la valeur par 
defaut est "no". 

Le document XML qui suit l'en-tete utilise des blocs de construction semblables a ceux des documents 
HTML pour structurer son contenu (elements, attributs, valeurs et commentaires). 

L'element 

Un element (appele aussi nceud) est l'entite de base du document XML. II peut contenir d'autres 
elements ou tout type de contenu (chaine de caracteres, autres elements, etc.). Le contenu d'un 
element est encadre par une balise ouvrante (exemple : <pere>) et une balise fermante (une balise 
fermante contient le meme nom que la balise ouvrante precede d'un slash. Exemple : </pere>). 
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Si 1' element ne possede pas de contenu, les balises ouvrante et fermante sont remplacees par une 
seule et unique balise comportant un slash apres le nom de l'element (exemple : <petitenfant />). 

Le nom indique entre ces deux balises doit decrire le contenu de l'element, mais il n'est pas predefini 
comme en HTML (<body>, <table>, <form>, etc.)- Si le nom de l'element est libre, il doit utiliser 
uniquement des lettres de l'alphabet, des chiffres ou les caracteres « - » et « _ ». II ne doit jamais 
contenir d'espace ou commencer par un chiffre. 

L'attribut 

II est possible d'ajouter des attributs a la balise ouvrante d'un element (exemple : <enfant 
nom="Paul ">). Les noms des attributs contenus dans une balise sont couples avec une valeur encadree 
par des guillemets (exemple : nom="Paul "). Un attribut doit toujours avoir une valeur. Le nombre 
d'attributs par element n'est pas limite, a condition que chaque nom d' attribut soit different (F exem- 
ple ci-apres est done incorrect: <pere nom="Durand" nom="Dupond">). Si un element comporte 
plusieurs attributs, ils doivent etre separes par des espaces (exemple: <pere prenom="Jean" 
nom="Dupond">). 

Les valeurs 

Dans un document XML, les valeurs peuvent correspondre a des valeurs d' attribut (exemple : 
nom="Paul ") ou a des valeurs d'element (exemple : <petitenfant nom="Alex">10</petitenfant>). 

Important 

La valeur d'un element doit etre consideree comme un element texte enfant a part entiere de cet element dans la 
hierarchie du document XML (voir figure 19-1). 



Les commentaires 

Comme pour le HTML, des commentaires peuvent etre ajoutes dans un document XML. La syntaxe 
est d'ailleurs identique a celle utilisee pour integrer des commentaires dans une page HTML 
(exemple :<! --Ceci est un commentai re XML-->). A l'interieur d'un commentaire, vous pouvez 
utiliser tout type de symbole sauf les doubles tirets « -- ». Les commentaires servent a annoter les 
documents XML afin de vous souvenir de l'utilite de certains blocs d'elements ou pour detailler la 
structure du document. Ils peuvent egalement servir a deboguer en neutralisant une partie du document 
afin qu'il ne soit pas visible par l'analyseur XML. 

Regies d'ecriture d'un document XML bien forme 

Meme si les documents XML sont simples et extensibles, ils n'en sont pas pour autant depourvus de 
regies. On appelle « document bien forme » un document qui respecte ces regies : 

• Un seul element racine - Chaque document XML doit posseder un seul element racine. 
L'element racine contient tous les autres elements du document. Cet element particulier s'appelle 
« nceud racine » ou « root ». 
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Exemple : 

<agesXpere>35</pereXpere>43</pereXages> 

(Ici, la balise ages est le nceud racine du document XML.) 

• Balises de fermeture obligatoires - Comme nous Favons vu precedemment, chaque element doit 
etre encadre par des balises ouvrante et fermante. Contrairement au HTML (dans lequel la balise 
<p> n'est pas obligatoirement fermee, de meme que <hr>, qui est une balise inherente sans balise 
de fermeture), le XML ne supporte pas F absence de balises fermantes. II faudra done veiller a 
toujours ajouter une balise de fermeture a tous les elements d'un document XML. Si le document 
possede un element vide, utilisez une balise unique avec un slash avant le signe > final (exemple : 
<enf ant/>). 

• Respecter l'imbrication des elements - Lorsque vous ouvrez un premier element puis un second, 
inserez la balise de fermeture du second avant celle du premier. Ainsi, le code suivant est 
incorrect : <a><b>contenu</a></b> alors que celui-ci est correct : <a><b>contenu</b></a>. 

• Respecter la casse - Le XML est sensible a la casse. Ainsi, les noms d' elements pere, Pere et PERE 
sont considered comme differents en XML. D' autre part, les noms des elements et des attributs 
doivent etre saisis en minuscules. 

• Mettre les valeurs des attributs entre guillemets - Si une balise contient un couple nom 
d'attribut et sa valeur, la valeur doit toujours figurer entre guillemets (simples ou doubles) 
(exemple : <enf ant nom="paul ">). 

• Utiliser les entites predefinies pour les caracteres reserves - Comme en HTML, il existe des 
caracteres reserves dont l'usage est interdit (<, >, &, ' et "). Pour chacun de ces caracteres, utilisez 
l'entite predefinie correspondante (<, >, &, ", &apos;). 

• Utiliser une section CDATA pour echapper un bloc de texte complet - Ann d'eviter d' utiliser 
des entites pour des longs blocs de texte comportant des caracteres reserves, vous pouvez ajouter 
une section CDATA en respectant la syntaxe suivante : <! [CDATA[bloc de texte]]>. 



Verification 

Pour savoir si un document est bien forme, une methode simple consiste a I'appeler avec un navigateur Internet 
recent (possedant un interpreter XML integre, comme les navigateurs posterieurs a IE 5 ou a Netscape 6 ; voir 
figure 19-2). 
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<?xml version="1.0" encoding="UTF-8" ?> 




- <ages> 




- <pere prenom="Jean" nom="Dupond"> 




- <enfant prenom="Paul"> 




<petitenfant prenom="Laurent">8</petitenfant> 




<petitenfant prenom="3uliGn h >5</petitenfant> 




</enfant> 




- <enfant prenom="Alain"> 




<petitenfant 




prenom="Charles">12</petitenfant> 




</enfant> 




</pere> 




- <pere prenom="Claude" nom="Durand"> 




- <enfant prenom="Fabrice"> 




<petitenfant prenom="Alex">10</petitenfant> 




<petitenfant prenom="Maxime">7</petitenfant> 




<petitenfant prenom="Fabien">3</petitenfant> 




s~ /a r\ fa n t"s 

^/ CI 1 Idl 




</pere> 




- <pere prenom="Thierry" nom="Duval"> 




- <enfant prenom="Micolas"> 




<petitenfant /> 




<! — Nicolas n'a pas d' enfant — > 




</enfant> 




</pere> 




</ages> 


v 


■jji] Termine * J Intranet local 



Figure 19-2 

Affichage d'un document XML bien forme dans un navigateur Internet 
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XML et Flash 



L' utilisation du XML dans Flash est de plus en plus frequente. Ce succes s'explique par les avantages 
du XML et la possibilite d'implementer des objets XML directement dans la programmation Flash. 
Les versions MX, MX 2004 puis 8 ont encore facilite l'utilisation des objets XML, renforce leur 
securite et, surtout, ameliore considerablement leurs performances. Desormais, tout flasheur doit 
savoir exploiter des documents XML au sein de ses developpements Flash. 

Utilisation des objets XML 

La classe XML 

La classe XML ressemble par bien des aspects a la classe LoadVars. Elle est utilisee pour formater 
ou analyser le contenu d'un document XML dans Flash ou pour charger ou envoyer un document 
XML externe. 

Une fois l'instance de la classe creee (objet XML cree avec new XML( )), on peut utiliser ses methodes 
(loadO, sendO, sendAnLoad( ), cloneNodeO, createEl ement( ), etc.) et ses nombreuses proprietes 
(chilNodes, firstChild, attributes, nodeValue, etc.). 

La methode toStringt ) permet de convertir un element XML en une chaine de caracteres. En gene- 
ral, son usage explicite n'est pas necessaire car elle est invoquee automatiquement des que Ton desire 
obtenir un element sous sa forme litterale. 

Comme la classe LoadVars, les classes getBytesLoaded( ) et getBytesTotal ( ) permettent, lors 
de l'utilisation des methodes load( ) ou sendAnl_oad( ), de connaitre le nombre d'octets telecharges 
(lorsque le chargement est en cours) et le nombre total d'octets telecharges (a la fin du chargement). 

La classe XML met a votre disposition deux proprietes, contentType et 1 oaded, qui permettent de modi- 
fier le type MIME des donnees avant un envoi et de savoir si un chargement est termine (dans ce cas, 
la propriete loaded estal'etat true). 
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Enfin, deux gestionnaires d'evenements, onData et onLoad, pennettent de controler la fin du charge- 
ment avant ou apres l'analyse des donnees par le Flash Player lors de l'usage d'une methode load( ) 
ou sendAndLoad( ). 

Tableau 20-1. Syntaxe du constructeur de la classe XML 

La classe XML permet de creer des objets XML (monObjet_xml) et d'utiliser ensuite leurs methodes pour envoyer ou charger 
des donnees. 

Creation d'un objet a I'aide du constructeur : 
var monObjet_xml = new XML(source) 

source : element XML optionnel qui sera analyse puis stocke dans le nouvel objet monObjet_xml . En cas d'absence d'ele- 
ment source, I'objet sera cree vide. II faudra ensuite lui ajouter un contenu a I'aide de methodes comme appenChi 1 d( ) ou 
parseXMLt ) (si le contenu doit etre formate en interne) ou load() (si le contenu est issu d'un document XML externe). 



Methodes des objets XML 



Tableau 20-2. Methodes d'envoi et de chargement de la classe XML 



Methodes 

monObjet_xml .loadCurl ") 

Importe un document externe depuis I'URL specifiee, analyse les donnees et les 
convertit en une hierarchie d'elements XML qui seront places ensuite dans I'objet 
monObjet_xml . 



monObjet_xml . send( "url " [ , "cibl e"] ) 

Convertit I'objet monObjet_xml en une chaine decode source XMLet I'envoieau 
script PHP localise par le parametre url. Le script destinataire peut eventuelle- 
ment renvoyer une reponse qui sera alors affichee dans la cible. 
Attention ! Selon la configuration de votre serveur, l'usage de cette methode sans 
le second argument peut ne pas fonctionner. Dans ce cas, utilisez la methode 
sendAndLoadt ) presentee ci-dessous. 

monObjet_xml .sendAndLoadt "url " , objet Cibl e_xml ) 

Envoie le code source XMLde I'objet monObjet_xml a I'URL specifiee et charge 
le document XML issu de la reponse du serveur dans I'objet objetCible_xml . 



Definitions des parametres 

url : URL absolue ou relative ou se 
trouve un document XML externe (dans le 
cas d'un chargement) ou un script PHP 
(dans le cas d'un envoi). Si le fichier SWF 
resultant de cet appel est ouvert dans un 
navigateur Web, I'URL doit etre du meme 
domaine que le fichier SWF. 
cible : fenetre du navigateur dans 
laquelle les reponses seront affichees. Par 
defaut, la cible est _self (fenetre cou- 
rante) mais vous pouvez utiliser _blank 
(nouvelle fenetre), _parent (fenetre du 
cadre parent) ou _top (fenetre du cadre 
principal). 

ObjetCible_xml : objet XML qui recoit le 
code source XML en retour. (Attention ! Le 
nom de cet objet ne doit pas etre encadre 
par des guillemets.) 
[xxx] : le code xxx est facultatif. 
(Attention ! Vous ne devez surtout pas sai- 
sir les crochets [ et ] dans le code.) 
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Tableau 20-3. Methodes de suivi de telechargement de la classe XML 



Methodes 

monObjet_xml .getBytesl_oaded( ) 

Renvoie le nombre d'octets deja telecharges lors du chargement d'un document 
XML initie par I'appel de la methode 1 oad( ) ou sendAndl_oad( ). 



Remarques 

Le nombre retourne par ces deux methodes 
indique une quantite d'octets. II convient 
de diviser ce nombre par 1 024 pour le 
convertir en kilo-octets (Ko). 



monObjet_xml . getBytesTotal ( ) 

Renvoie le nombre d'octets total telecharges apres le chargement d'un document 
XML initie par I'appel de la methode 1 oad( ) ou sendAndLoadt ). Cette methode 
renvoie undefined si aucune operation load n'est en cours. 



Tableau 20-4. Methodes de formatage de la classe XML 



Methodes 

el em_xml node . appendChi 1 d( el emEnf ant_xml node) 
Cette methode ajoute I'element enfant el emEnf ant_xml node (y compris sa filia- 
tion) a I'element elem_xmlnode ou deplace I'element si el emEnf ant_xml node 
est un element existant du document XML. Dans le cas d'un deplacement, 
el emEnf ant_xml node indique I'ancien emplacement de I'element et 
el em_xml node indique le nouveau parent de I'element. 

el em_xml node.cl oneNodet recursivement ) 

Cette methode construit et renvoie un nouvel element XML possedant les memes 
type, nom, valeur et attribut que I'element XML specifie. Si recursivement est 
defini sur true, tous les elements enfants sont recursivement clones. On obtient 
ainsi une copie exacte de I'arborescence des documents de I'element original. 

el em_xml node. create El ementt "nom" ) 

Cette methode cree un element XML portant le nom specifie dans le parametre 
(nom). Le nouvel element n'a, au debut, ni parent, ni enfants, ni freres. 

el em_xml node. createText Node ( "texte" ) 

Cette methode cree un element texte XML avec pour valeur le texte specifie en 
argument (texte). Le nouvel element n'a aucun parent au moment de la creation. 

elem_xmlnode.removeNode( ) 

Cette methode supprime I'element XML specifie de son parent. Tous les descen- 
dants de I'element sont egalement supprimes. 
el em_xml node . i nserBef ore( el emEnf ant l_xml node , 
el emEnf ant2_xml node ) 

Cette methode insere dans I'element elem_xmlnode un element enfant 
el emenXml Enfantl_xml node devant un element enfant existant 
el emenXml Enf ant2_xml node. 

el em_xml node. hasChi Id Node ( ) 

Cette methode verifie si un element a des descendants. Elle retourne la valeur 
true si un element a des enfants et la valeur false dans le cas contraire. Elle peut 
etre utilisee notamment dans une expression de condition afin de s'assurer que 
des enfants d'un element existent avant d'effectuer un traitement. 



Definitions des parametres 

el em_xml node : occurrence de la classe 
XMLnode. La classe XML etant une sous- 
classede lasuperclasse interne XMLnode, 
cet element peut etre une occurrence de 
la classe XML (done un objet XML habi- 
tuellement nomme monObjet_xml dans 
les autres exemples) ou un element XML 
issu de la hierarchie de cet objet. 
el emEnf ant_xml node : nom d'un ele- 
ment XML enfant par rapport a 
el em_xml node. 

monObjet_xml : occurrence de la classe 
XML. II represente exclusivement I'ele- 
ment XML de niveau le plus eleve dans la 
hierarchie objet XML (contrairement aux 
elements nommes elem_xmlnode dans 
les exemples ci-contre). 
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Tableau 20-4. Methodes de formatage de la classe XML (suite) 

Methodes Definitions des parametres 

monObjet_xml .parseXML (chaine) 

Cette methode lit et parse le code source XML contenu dans chaine puis le 
convertit en une hierarchie d'elements XML qui seront ensuite places dans I'objet 
monObjet_xml . Apres le traitement de la chaine, la propriete status de I'objet 
monObjet_xml est mise a 0 si I'operation a reussi (dans le cas contraire, les 
codes d'erreur vont de - 2 a - 10 ; voir le tableau 20-8 pour connaitre les diffe- 
rents codes d'erreur). 

el em_Xml node.toString( ) 

Cette methode evalue I'element XML specifie, construit une representation tex- 
tuelle de la structure XML en incluant les elements et leur filiation ainsi que les 
attributs, puis renvoie le resultat sous la forme d'une chaine. A noter : Cette 
methode est souvent appelee implicitement par Flash des que Ton sollicite un ele- 
ment sous sa forme litterale. II n'est done pas necessaire dans la major ite des cas 
d'invoquer toString( ) d'une maniere explicite. 

Tableau 20-5. Proprietes de ciblage d'element de la classe XML 

Descriptions des proprietes 

elem_xmlnode.attributes.nomAttribut 
elem_xmlnode.attributes["nomAttribut"] 

Cette propriete (en lecture/ecriture) renvoie un tableau associe contenant tous les attributs de Pelement el em_xml node. Deux 
syntaxes peuvent etre utilisees : syntaxe pointee avec le nom de I'attribut separe par un point (el em_xml node. attribu- 
tes .nomAttri but) ou syntaxe propre au tableau de variables avec le nom de I'attribut entre crochets (el em_xmlnode.attri - 
butesfnomAttribut"]). 

elem_xmlnode.childNodes[n] 

Cette propriete (en lecture seule) renvoie un tableau contenant les enfants de I'element el em_xml node. L'acces a un element 
particulier du tableau est possible grace a son indice (n). Ainsi, le premier element sera identifie par I'indice 0 
(elem_xml node.chi 1 Nodes [0]), le second par I'indice 1 (el em_xml node. chi 1 Nodes [1]) et ainsi de suite. A noter : Le pre- 
mier element du tableau peut aussi etre cible en utilisant la propriete firstChild (par consequent, la reference 
el em_xml node.chi 1 Nodes [0] equivauta el em_xml node.fi rstCrril d). D'autre part, cette propriete etant du type tableau de 
variables, il est interessant d'utiliser la propriete length afin de connaitre le nombre d'elements enfants de I'element XML refe- 
rence (exemple : el em_xml node.chi 1 Nodes . 1 ength) pour parametrer une expression de condition de boucle, par exemple. 

el em_xml node .firstChild 

Cette propriete (en lecture seule) fait reference au premier enfant de la liste des enfants de I'element parent el em_xml node. 
Cette propriete est null si I'element n'a pas d'enfant. Elle est undefined si I'element est un element texte. Comme nous I'avons 
precise ci-dessus, cette propriete est identique a la reference el em_xml node.chi 1 Nodes [0]. 

elem_xmlnode.lastChild 

Cette propriete (en lecture seule) retourne une reference au dernier enfant de la liste des enfants de I'element parent 
el em_xml node. Cette methode renvoie null si I'element ne possede pas d'enfants. A noter : cette propriete equivaut a I'usage 
de la reference el em_xml node.chi 1 dNodes[el em_xml node.chi 1 dNodes . 1 ength-1]. 

el em_xml node . nextSi bl i ng 

Cette propriete (en lecture seule) fait reference au frere suivant dans la liste des enfants de I'element parent el em_xml node. 
Cette methode renvoie null si I'element ne possede pas d'element frere suivant. 
el em_xml node.previousSibl i ng 

Cette propriete (en lecture seule) retourne une reference a I'element precedent et de meme niveau que I'element reference 
el em_xml node. S'il n'y a pas d'element precedent, la valeur de la propriete est null. 
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Tableau 20-5. Proprietes de ciblage d'element de la classe XML (suite) 



el em_xml node . nodeName 

Cette propriete (en lecture/ecriture) retourne le nom de I'element XML reference el em_xml node. Si I'element XML est un ele- 
ment XML (nodeType == 1), nodeName retourne le nom de la balise representant I'element dans le fichier XML. Si I'element 
XML est un element texte (nodeType == 3), nodeName est egal a nul 1 . 

el em_xml node . nodeType 

Cette propriete (en lecture seule) retourne le type d'un element. Le DOM XML reference douze types d'elements differents pour 
un objet XML, mais avec Flash seuls deux types d'objet XML peuvent etre accedes en direct. Ainsi, la propriete nodeType aura 
la valeur 1 pour un element XML (occurrence de la classe XML ou de la classe XMLnode) et la valeur 3 pour un element texte. 

elem_xmlnode.nodeValue 

Cette propriete (en lecture/ecriture) retourne la valeur chaine de I'element el em_xml node. La propriete nodeVal ue aura pour 
valeur null pour un element XML et la chaine de caracteres contenue par I'element pour un element texte. 

el em_xml node. pa rent Node 

Cette propriete (en lecture seule) retourne une reference a I'element parent dont est issu I'element reference el em_xml node. 
Si I'element reference est a la racine du document XML (I'element de plus haut niveau), la propriete retourne la valeur null. 



Tableau 20-6. Autres proprietes de la classe XML 

Descriptions des proprietes 

monObjet_xml .ignoreWhite 

Cette propriete (en lecture/ecriture) memorise une valeur booleenne (true ou f al se) qui indique s'ilfautsupprimer les espaces 
blancs contenus dans le document XML monObjet_xml lors d'une operation d'analyse (initiee par des methodes de charge- 
ment comme 1 oad( ) ou sendAndLoad( ) par exemple). La valeur par defaut est false. Lorsque cette valeur est true, les ele- 
ments texte qui ne contiennent que des espaces blancs sont supprimes au cours de Panalyse. II suffit d'affecter la valeur true a 
cette propriete avant d'appeler la methode de chargement (exemple : monObjet_xml .ignoreWhite = true). 

monObjet_xml . 1 oaded 

Cette propriete (en lecture seule) determine si le processus de chargement du document initie par I'appel d'une methode 
1 oad( ) ou sendAndLoadt ) est acheve. Si le processus s'est acheve avecsucces, la methode renvoietrue. Sinon, elle renvoie 
false. Cette methode peut etre utilisee pour gerer le chargement d'un document XML (detecte le chargement complet d'un docu- 
ment XML avant d'exploiter les donnees) mais en pratique cette fonction est frequemment assuree par le gestionnaire 
onl_oad( ). 

monObjet_xml .status 

Cette propriete (en lecture seule) indique si le traitement applique a I'objet XML monObjet_xml a reussi lors de ['utilisation du 
constructeur XMLou des methodes parseXML( ), loadt ) et sendAndLoadt ). Elle retourne la valeur 0 si I'operation s'est bien 
deroulee ou un code d'erreur dans le cas contraire (de - 2 a - 10 selon I'origine du probleme rencontre ; voir la liste detaillee 
de ces erreurs dans le tableau 20-8). 

monObjet_xml .xmlDecl 

Cette propriete (en lecture/ecriture) memorise I'element declaratif de I'objet XML monObjet_xml (par exemple : <?xml ver- 
sion^!. .0" ?> ). Si cet element n'existe pas dans I'objet XML, la valeur de cette propriete est alors egale a undefined. 

mon0bjet_xml .contentType 

Cette propriete (en lecture/ecriture) memorise le type MIME de I'objet mon0bjet_xml . Cette propriete est envoyee au serveur 
lors de I'usage d'une methode sendt ) ou sendAndLoadt ). Par defaut, sa valeur est egale a appl ication/x-www-form- 
url encoded (doncau format detype &variabl e=val eur). Comme la propriete est aussi accessible en ecriture, sa valeur peut 
etre modifiee avant I'envoi des informations au serveur si necessaire. 
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Tableau 20-7. Gestionnaires d'evenements de la classe XML 



Gestionnaire d'evenements 

monObjet_xml .onData = function (src) { 
// Mettre ici vos instructions } 
Le gestionnaire d'evenements onData est invoque si les 
elements XML (src) ont ete completement telecharges 
lors d'un chargement initie par I'appel de la methode 
loadO ou sendAndLoadt ). Ce gestionnaire etant invo- 
que avant I'analyse des donnees, il peut etre utilise pour 
appeler une routine d'analyse personnalisee au lieu d'une 
routine integree dans Flash Player. Par defaut, la routine 
appelee est monObjet_xml .onLoad (voir ci-dessous) 
mais si vous affectez une fonction personnalisee a 
monObjet_xml .onData, la routine 

monObjet_xml .on Load ne sera plus appelee, a moins 
que vous ne I'ajoutiez dans les instructions de la fonction 
personnalisee. 

monObjet_xml .onLoad = function (succes) { 
// Mettre ici vos instructions ) 
Si aucune fonction personnalisee n'est affectee a I'objet 
monObjet_xml .onData (voir ci-dessus) le gestionnaire 
d'evenements onLoad est invoque par defaut des que le 
chargement initie par I'appel de la methode loadO ou 
sendAndLoad( ) est termine. 



Definitions des parametres 

src : chaine contenant le code source des elements XML telecharges . 
A noter : Si une erreur se produit lors du chargement, le parametre scr 
sera affecte par la valeur undefined. 

succes : ce parametre indique si I'operation de chargement s'est derou- 
lee avec succes (true) ou non (f al se). 

Remarque : En pratique, dans la plupart des applications, on utilise uni- 
quement le gestionnaire d'evenements onLoad pour gerer les telecharge- 
ments de document XML (voir exemple ci-dessous). 
Exemple : 

script place dans I'image 1 du scenario principal de I'animation 
chargeXml .fla : 
monDoc_xml = new XMLO; 
monDoc_xml .ignoreklhite = true; 

// 



//Declaration du gestionnaire onLoad. 

//Le gestionnaire sera declenche des que le chargement du 
fichier XML sera termine. 

monDoc_xml .onLoad = function(succes) ( 
if (succes) { 

var racine = thi s .f i rstChi 1 d; 
// Pointe sur 1 'element racine du document XML 



trace( "tel echargement reussi du document 

*XML="+racine); 

} else ( 

tracet "Erreur de tel echargement du document 
*XML"); 



); 

// 

//Chargement du fichier XML 
monDoc_xml . 1 oad( "ages .xml " ) ; 



Creer un objet XML 

Les exemples ci-dessous creent un meme objet XML de quatre manieres differentes. Au terme de 
chaque script, le contenu de I'objet monDoc^xml sera egal a <ages><pere>35</pere></ages>. 

Exemple 1 : creation d'un objet XML vide puis chargement d'un document XML externe 
(agePere.xml) dans celui-ci : 

var monDoc_xml = new XMLO ; 
monDoc_xml .ignoreWhite = true ; 
monDoc_xml . 1 oad( "agePere.xml " ) ; 
monDoc_xml .onLoad = function(succes)( 
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if (succesH 

trace( "monDoc_xml ="+monDoc_xml . f i rstChi 1 d ) ; 

} 

} 

Pour l'exemple 1, le contenu du document exterieur agePere.xml est le suivant : 

<?xml version="1.0" encoding="UTF-8"?> 
<ages><pere>35</pere></ages> 

Exemple 2 : creation d'un objet XML vide puis ajout du contenu a Faide de la methode parserXMK ). 
Le bon traitement du contenu peut ensuite est verifie a Faide de la propriete status de l'objet XML 
(status retourne la valeur 0 si le traitement s'est bien deroule et un code d'erreur - de - 2 a - 10 - 
dans le cas contraire ; voir le tableau 20-8 pour connaitre les differents codes d'erreur) : 

var monDoc_xml = new XMLO ; 

monDoc_xml . parseXMK "<ages><pere>Jean</pere></ages>" ) ; 

trace( "monDoc_xml ="+monDoc_xml ); // <agesXpere>Jean</pereX/ages> 

trace( "status="+monDoc_xml .status) ; // status=0 

Exemple 3 : creation d'un objet XML avec passage du contenu en argument : 
chaineXml="<agesXpere>35</pereX/ages>" ; 
var monDoc_xml = new XMLtchaineXml ) ; 
traceCmonDoc_xml="+monDoc_xml ) ; 

Exemple 4 : creation d'un objet XML vide puis creation des elements du contenu et ajout successif 
de ceux-ci dans l'objet XML avec la methode appendChi 1 d( ) : 

var monDoc_xml = new XMLO ; 

el emAges=monDoc_xml . createEl ement( "ages" ) ; 

el emPere=monDoc_xml .createEl ement( "pere" ) ; 

el emTexte=monDoc_xml .createTextNode("35") ; 

elemPere.appendChild(elemTexte); // <pere>35</pere> 

elemAges.appendChild(elemPere) ; // <agesXpere>35</pereX/ages> 

monDoc_xml .appendChild(elemAges) ; 

tracet "monDoc_xml ="+monDoc_xml ) ; 



Testez vos scripts XML en mode debogage 

II n'est pas toujours evident de suivre revolution de toutes les proprietes d'un objet XML lors des tests, meme si 
dans tous les exemples qui suivent, nous avons ajoute de nombreuses fonctions trace( ) afin que vous puissiez 
comprendre les evolutions d'une etape a I'autre dans I'environnement de controle de Flash. Si vous desirez suivre 
precisement les modifications de chaque propriete, nous vous recommandons de poser des points d'arret dans les 
scripts etudies afin d'utiliser le debogueur Flash. Vous pourrez ainsi apprecier tous les changements de valeur 
d'une etape a I'autre, mais aussi suivre les modifications de la hierarchie de l'objet en deroulant I'arbre de sa 
filiation (childNodes ; voir figure 20-1). 
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Figure 20-1 

Utilisez le debogueur pour observer la hierarchie d'un objetXML ou pour suivre revolution de ses proprietes. 
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Figure 20-2 

Principe du chargement d'un document XML dans une application Flash d I'aide de la methode load( ) 

Nous avons vu precedemment qu'il est possible de traiter des donnees creees directement dans Flash. 
En pratique, il n'est pas rare que les donnees soient importees depuis un fichier XML externe. Pour 
illustrer cette technique, nous vous proposons de creer une petite application qui chargera le contenu 
d'un fichier XML externe (ages . xml , voir figure 20-3) dans une zone de texte dynamique. 
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<pere preno»»"Jean" noM""Dupond"> 
<en£ant preno»-"Paul'*> 

<petiten£ant pEeno»«"Lautent">8<./petiten£ant> 
<pe ti tent ant p t enOM- " Jul l en"> 5< /p e ti tenfano 

</en£ant> 
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<petiten£ant preno»-"Charle3">12</petiten£ant> 

</en£ant> 
</pere> 

<pere pteno»-"Claude" nom»"Curand"> 
<enf ant pceno»*"FabEice"> 

<petiten£ant ptenott="Ale:%" >10</petitenCant> 
<petiten£ant preno»«"Haxiae">7</petlten£ant> 
<petiten£ant pEeno*-"Fabien">3</petlten£ant> 

</en£ant> 
</pere> 

<pece ptenoB""Tniecty" no*» "Duval "> 
<en£ant preno»-"Hicolas"> 
<petitenf ant /> 

<! — Nicolas n'a pas d' enfant --> 

</enfant> 
</peie> 
</ages> 
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Figure 20-3 

Creation dufichier ages.xml qui sera charge dans V application Flash 



Pour charger un fichier XML dans une application Flash, il faut utiliser la fonction loadO mais si 
Ton observe sa syntaxe (revoir tableau 20-2), on s'apercoit qu'un objet XML (exemple : 
chargement_xml) doit etre prealablement cree afin de receptionner les donnees lors de l'appel de la 
methode load( ) (exemple: chargement_xml .load( "ages.xml ")). 

II faut done creer cet objet en utilisant la syntaxe du constracteur presentee au debut de ce chapitre 
(revoir tableau 20-1) : 

chargement_xml = new XMLO; 

Dans les documents XML externes, des espaces blancs sont souvent presents entre les balises. Dans 
la phase d' analyse du document, ces blancs sont transformes en elements texte contenant un espace 
vide et risquent de perturber le referencement des elements utiles lors de la phase de traitement des 
donnees. II faut done les eliminer des le chargement du fichier en activant la propriete i gnoreWhi te. Si 
la valeur true est affectee a cette propriete, F elimination des blancs s'effectue automatiquement 
pendant la phase de chargement : 

chargement_xml .i gnoreWhi te = true; 
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Zone de chargement du flchier XML 
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\ As«s(««rie script 



1 // Creation de l'oblet XRL avec le CONSTRUCTEUR 

2 ehargement_xml - new >:11L(); 

3 chatgement_xral . ignoreHhite " true; 



// GESTICWNAIRE OnLoad 

chargement_xn>l . onLoad - function (succes) ( 
If (succes) ( 

v*r racine " chis.firstchild; 

//polnte sur l'objet racine du document XHL 
of f icheDoc_txt . text -racine; 
) else 1 

aff lcheDoc_txt.text""Erreur de teleehargement du docu 



-Appel de la KETHODE load 1 1 



13 

14 ) 

15 ); 

16 // 

17 

19 

19 chargement_xml . loadt "agea . xml") ; 

20 //chargement_xml . load I "agea. xml?ant i cache- "♦Hath, random ( ) ) ; 
21 

| 
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Figure 20-4 

Creation de I 'application de chargement d'un fichier XML : load.fla 



Pour savoir si le document est completement charge, il faut utiliser l'evenement onLoad. Pour cela, 
nous utilisons la methode de gestionnaire d'evenement on Load ( ) de la classe XML qui est identique 
a celle que nous avons detaillee lors du chargement d'un simple fichier texte avec loadVars( ). Dans 
notre exemple, si le chargement s'est deroule correctement, la variable succes sera egale a true et le 
contenu du document XML s'affichera dans une zone de texte dynamique af f i cheDoc_txt placee au 
centre de la scene. Dans le cas contraire, un message d'erreur indique l'echec du chargement dans 
cette meme zone : 

chargement_xml .onLoad = function(succes) { 
if (succes) { 

var racine = this.fi rstChild; 

// Pointe sur 1'objet racine du document XML 

afficheDoc_txt.text=racine; 

} else { 

afficheDoc_txt.text="Erreur de teleehargement du document XML"; 

} 

); 
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II ne reste plus qu'a saisir Finstruction d'appel de la fonction 1 oad( ) afin de declencher le debut du 
chargement. Assurez-vous au prealable que le fichier XML est present dans le meme repertoire ou 
modifiez son chemin afin qu'il corresponde a la localisation du fichier dans l'arborescence du site. 
Apres le chargement, vous devez voir apparaitre les differents elements du document XML dans le 
panneau Sortie : 

chargement_xml . 1 oad( "ages .xml " ) ; 



element texte 

nodeValue = 
8 



:petitenfant= epetitenfant: 



T 



clement texte 

nodeValue ■ 
5 



element texte 

nodeValue = 
12 



pronom="Lauront" 



pronom=" Julian" 



element texte 

nodeValue = 
10 



petitenfant: = petitenfanP cpetitenfanf e petite nf a nP 



pronofn="Cr.»rli«' 



<enfant> 

prenom="Paul" 



element texte clement texte 



nodeValue = 
7 



nodeValue = 
3 



«VALEURS DES ELEMENTS 
(ages des petits enfants) 



prcnom= 'Aloi" 



<enfant> 

prenom="Alain" 



<pere> 

nom="Dupond" 
prenom="Jean" 



pronom="Ma«imo' 



prenom=~Fabi«n" 



<enfant> 

prenom="Fabrice" 



<pere> 

nom="Durand" 
prenom="Claude" 



<ages> 

(racine du document) 



Pointeur 
racine = 
chargement_xml.fi rstChild 



Flash-root 



<enfant> 

prenom="Nicolas" 



<pere> 

nom="Duval" 
prenom="Thierry" 



racine 



Figure 20-5 

Lorsque le document XML est charge dans Flash, un element racine supplementaire nomme Flash-root est ajoute 
automatiquement a la hierarchie de I'objet XML (a comparer avec la figure 19-1). 
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Vous trouverez ci-dessous le code complet pour charger un fichier ages.xml place dans le meme 
repertoire que le document SWF (voir figure 20-4). 



A noter 

Nous avons affecte un pointeur sur le premier niveau de I'objet XML a I'aide de la variable racine (var racine = 
this.firstChild) afin d'obtenir la meme structure que le document XML externe. En effet, lors du chargement, 
Flash cree automatiquement un niveau supplemental parent de la racine du document (I'element Flash- 
root). Cette variable racine permet de retrouver exactement la meme hierarchie que dans le document 
d'origine (voir figure 20-5). 



chargement_xml = new XMLO; 

chargement_xml .ignoreWhite = true; 

// 

chargement_xml .onLoad = function(succes) { 
if (succes) { 

var racine = this.firstChild; 

// Pointe sur I'objet racine du document XML 

afficheDoc_txt.text=racine; 

} else { 

afficheDoc_txt.text="Erreur de telechargement du document XML"; 

} 

1; 

// 

chargement_xml . 1 oad( "ages.xml " ) ; 

Enregistrez votre document sous le nom load.fla dans le meme repertoire que le fichier XML 
ages . xml . Publiez-le puis testez son fonctionnement dans le Web local (voir figure 20-6). 
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Figure 20-6 

Test de I 'application de chargement d'un fichier XML dans le Web local 
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A noter 

Cette application ne necessitate pas I'execution d'un script PHP peut aussi etre testee en mode controle dans 
Flash, mais il est preferable de I'enregistrer et de la tester dans le Web local pour la suite des essais. 



Cette procedure de chargement fonctionne tres bien pour le premier chargement. Cependant, si Fune 
des valeurs du fichier change et que vous le chargez de nouveau, rinformation modifiee risque de ne 
pas etre actualisee dans la zone de texte. En effet, le cache du navigateur (ou des proxies) memorisant 
toutes les informations que vous chargez afin d'optimiser votre navigation sur Internet, le second 
chargement ne chargera pas le fichier actualise issu du serveur mais celui du cache correspondant au 
premier chargement. Dans ce cas, une solution simple consiste a ajouter un parametre aleatoire dans 
l'URL d'appel du fichier. Ainsi, le nom complet du fichier etant different, son chargement depuis le 
serveur sera force a chaque fois que vous le solliciterez. 



Attention ! 

Le parametre aleatoire etant passe dans l'URL, I'appel en local (ou en mode test) ne fonctionnera plus et il vous 
faudra obligatoirement tester son fonctionnement depuis le Web local ou votre serveur distant. Afin que vous puis- 
siez continuer a tester votre application en mode controle dans Flash, nous vous suggerons de conserver une 
instruction d'appel de la methode 1 oad( ) sans cette variable aleatoire. II vous suffira de commenter I'une ou I'autre 
des instructions d'appel selon I'environnement de test utilise : 

// Chargement_xml . 1 oad( "ages .xml ") ; // Pour test en local 
chargement_xml . 1 oad( "ages .xml ?anti cache= "+Math . random ( ) ) ; 
Une autre solution consiste a passer une variable de temps dont la valeur 
sera initial i see a chaque chargement avec la methode getTimeO : 
chargement_xml . 1 oad( "ages .xml ?anti cache= "+ new Date( ) .getTime( ) ) ; 



Envoyer un objet XML 

Pour exporter un objet XML, il faut utiliser une methode send( ) ou sendAndl_oad( ) et disposer d'un 
script recepteur sur le serveur. Dans le cadre de cet ouvrage, ce script sera programme en PHP et aura 
pour fonction de recuperer les donnees envoyees par 1' application Flash et de les afficher dans le 
navigateur ou de les enregistrer au format XML dans un fichier sur le serveur. 

Parametrage de contentType 

Assurez-vous dans un premier temps que les donnees envoyees par 1' application Flash peuvent etre 
correctement recuperees par le script PHP. Par defaut, le type des donnees transmises par Flash 
(contentType) est application/x-www-form-urlencoded (au format &vari abl e=val eur). Dans ce cas, 
les donnees sont analysees (identification des couples variables/valeurs) puis transferees automati- 
quement dans le tableau de variables HTTP $_P0ST (par exemple : $_P0ST[ 'variable' ]=val eur) 
comme dans les interfacages precedents. Cependant, les donnees XML ne sont pas structurees au 
format &variable=valeur mais composees d'une hierarchie d'elements et peuvent difficilement etre 
recuperees cote PHP avec ce parametrage par defaut. II faut done modifier le contentType et lui 
affecter la valeur text/xml afin que les donnees ne soient ni analysees ni transferees dans le 



tableau de variables $_POST mais conservent leur structure initiale et restent dans la variable 
$HTTP_RAW_POST_DATA cote serveur. 

Utilisation du flux php://input 

Avant la version 4.3 de PHP, la methode decrite ci-dessus permettait de recuperer puis d'interpreter 
des donnees XML issues d'une application Flash mais necessitait une configuration specifique du 
fichier php.ini (la directive always_populate_raw_post_data devait etre initialisee avec la valeur On). 
Depuis PHP 4.3, il est possible d'utiliser le flux php://input qui permet de lire des donnees POST 
brutes. Cette methode necessite moins de memoire que $HTTP_RAW_POST_DATA et aucune directive 
speciale ne doit etre configuree dans php.ini. La suite de Wamp 5 utilisee pour nos essais comporte 
une version de PHP 5 done ulterieure a 4.3 ; nous utiliserons done cette methode dans les scripts 
d'envoi de donnees XML (send( ) et sendAndLoadO) ci-dessous. 

Methode send() 

Gestion de la connexion avec send() 

Lorsque Ton appelle une methode send( ), une connexion client-serveur est ouverte durant la trans- 
mission des donnees de 1' application Flash vers le serveur. Des la fin du transfert, cette connexion est 
fermee : 1' application Flash n' attend pas de reponse de la part du serveur (contrairement a la methode 
sendAndLoadO que nous allons presenter ensuite). Des reception des elements XML, le script PHP 
peut traiter leur contenu, les enregistrer dans un fichier XML (voir repere 2 de la figure 20-7) et/ou 
rediriger des informations issues du traitement vers la fenetre d'un navigateur (grace au parametrage 
du second argument optionnel de la methode send( ), voir repere 1 de la figure 20-7). 



Figure 20-7 
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Envoi d'un objet XML et affichage dans le navigateur 

Creation du document Flash : send.fla 

Ouvrez un nouveau document Flash et enregistrez-le sous le nom send.fla. Dans l'image cle 1 du 
scenario principal, saisissez le code suivant (voir figure 20-8) : 

// Creation de 1 'objet envoi_xml 
var envoi_xml = new XMLO; 

// Configuration des parametres de 1 'objet envoi_xml 
envoi_xml .ignoreWhite = true; 
envoi_xml .contentType = "text/xml"; 

envoi_xml .xml Decl = '<?xml version="1.0" encoding="UTF-8"?>' ; 
// Affectation du contenu de 1 'objet envoi_xml 

envoi_xml .parseXMU '<ages><pere prenom="Jean" nom="Dupond"><enfant prenom="Paul "> 
**<peti tenfant prenom="Laurent">8</peti tenf antX/enfantX/pereX/ages> ' ) ; 
// Envoi avec la methode sendO 

envoi_xml . send ( "reception. php" , "_bl ank" ) ; 
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\ Assistant de script 



1 //creation de 1' objet envoi xtnl * 

Z var envoi_xml - new XKM); 

3 //configuration des parametres de l'objet envoi_xml 

4 envoi_xrnl. ignoreUhite ■ crue; 

5 envoi_x»l. contentType ■ "text/xml"; 

6 envol_xml.xiDlDecl ■ '<?xml version""!.©" encoding""UTF-8"?>' ; 

7 //art ectation du contenu de I' objet envoi_xtnl 

8 envoi_xml. parseXHH ' <agesxpere prenon»-"Jean" nom-"Dupond"xe 

9 //envoi avec la methode send() 

10 envoi_x»l.send("reception.php","_blanlc") ; 
11 



Figure 20-8 

Creation du document send.fla 



Le script AS commence par une instruction appelant le constructeur XML afin de creer l'objet 
envoi_xml. Les trois lignes de code suivantes sont destinees a configurer les proprietes du nouvel 
objet XML. La propriete ignoreWhite est initialisee avec la valeur true afin d'eviter les problemes 
lies aux espaces blancs entre les balises XML. La propriete contentType est initialisee avec la valeur 
text/xml afin de pouvoir recuperer correctement le contenu de l'objet XML depuis le script PHP 
(revoir cette propriete en debut de chapitre). Enfin, la propriete xml Decl est initialisee avec une balise 
de declaration conforme aux normes des fichiers XML afin que le fichier XML cree par le script PHP 
soit bien forme. 

La methode parseXMU ) permet d'affecter les differents elements XML a l'objet envoi_xml. La 
methode sendO est ensuite appelee a la fin du script. Son premier argument correspond au fichier 
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PHP destinataire de l'envoi, alors que le second argument indique que les eventuelles donnees affi- 
chees par le script devront etre rediriges vers une nouvelle fenetre du navigateur (_bl ank). Une fois le 
script saisi, enregistrez votre document et publiez-le dans un sous-repertoire de wamp\www\ (par exemple 
le repertoire SITEf 1 ash\6-xml \chap20\). 

Creation du script PHP : reception. php 

Dans un premier temps, vous allez afficher les donnees XML recuperees par le script PHP dans une 
fenetre de navigateur. Si les resultats affiches dans le navigateur sont bien formes vous modifierez 
ensuite le script PHP afin d'enregistrer ces memes donnees dans un fichier XML. 

Ouvrez un nouveau document PHP dans Dreamweaver puis saisissez le code ci-dessous. Ce document 
sera sauvegarde sous le nom reception. php dans le meme repertoire que le fichier SWF genere 
precedemment : 

<?php 

header("Content-Type: text/xml ") ; 
// 

$reception_xml = file_get_contents("php://input"); 
echo $reception_xml ; 
// 

?> 

Ce script est constitue d'une premiere ligne generant un header de fichier compatible avec le type 
configure dans l'application Flash (text/xml). La seconde ligne permet de recuperer les donnees 
XML depuis le flux php : //i nput (revoir si necessaire l'utilisation du flux php : 1 1\ nput au debut de ce 
chapitre). La derniere instruction permet d' afficher le document XML precedemment recupere dans 
le navigateur afin de s' assurer qu'il est bien forme. 

Test du systeme dans le Web local 

Enregistrez le fichier recepti on . php dans le meme repertoire que l'application Flash et passez dans le 
Web local pour tester le fonctionnement de cette premiere interface Flash-PHP-XML. Parcourez les 
repertoires pour localiser vos scripts et appelez le fichier HTML contenant l'application Flash. Des 
l'appel de l'application Flash, le fichier XML doit etre cree puis transfere au script PHP. Une 
nouvelle fenetre de navigateur s'ouvre pour afficher le contenu de l'objet XML transfere. Si l'objet 
XML est bien forme, il est interprete par le navigateur et sa hierarchie complete s'affiche dans le 
navigateur (chaque element est precede d'un symbole + ou - qui permet de deplier ou replier ses 
elements enfants) (voir figure 20-9). 

Envoi d'un objet XML et enregistrement dans un fichier 
Modification du document Flash : send.fla 

Avant de modifier le script PHP, ouvrez de nouveau le document FLA afin de modifier le parametrage 
de la methode send ( ) . Pour ne pas afficher le contenu de l'objet dans un navigateur, supprimez le second 
argument (_bl ank) dans les parentheses de l'appel de la methode send( ). L'objet XML est toujours 
envoye au script PHP par le biais du flux php: //input, mais les eventuelles donnees affichees par le 
script ne sont pas redirigees vers un navigateur et les elements XML sont enregistres directement dans 
un fichier cote serveur (recepti on. xml). Voici la ligne de script a modifier dans le document send.fla : 

| envoi_xml .sendC'reception.php") ; 
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<?xml version="1.0" encoding="UTF-8" ?> 
- <ages> 

- <pere prenom="Jean" nom="Dupond"> 
- <enfant prenom="Paul"> 

<petitenfant prenom="Laurent">9</petitenfant> 
</enfant> 
</pere> 
</ages> 




£\ Termine * J Intranet local 



Figure 20-9 

Hierarchie de I'objet XML interprets par le navigateur apres sa reception par le script reception.php 



Si la methode send() ne fonctionne pas sans le second argument 

Lors de nos tests, nous avons constate que, selon la configuration du serveur, la methode send( ) sans le second 
argument peut ne pas fonctionner. Si vous rencontrez ce probleme, utilisez la methode sendAndl_oad( ) (voir la 
presentation de cette methode ci-dessous). 



Modification du script PHP : reception.php 

Apres avoir enregistre et publie de nouveau l'application Flash, ouvrez le fichier recepti on . php. A la 
fin de ce fichier, supprimez l'instruction echo destinee initialement a afficher le contenu de I'objet 
XML dans un navigateur. Ajoutez ensuite les lignes en gras du script ci-dessous afin de gerer l'enre- 
gistrement du contenu de I'objet XML recupere dans un fichier recepti on . xml : 

<?php 

header ( "Content-Type : text/xml " ) ; 
// 

$reception_xml = file_get_contents("php://input") ; 
II 

$fichierXml = "reception .xml " ; 
$fp = fopen($fichierXml , "w"); 
fwrite($fp. $reception_xml ) ; 
fclose($fp) ; 
?> 
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Test du systeme dans le Web local 

Enregistrez le nouveau fichier reception.php dans le meme repertoire que l'application Flash et 
passez dans le Web local pour tester le fonctionnement de l'interfacage Flash-PHP-XML. Parcourez 
les repertoires pour localiser vos scripts et appelez le fichier HTML contenant l'application Flash. 
Des l'appel de l'application Flash, le fichier XML doit etre cree mais aucune fenetre ne s'ouvre car 
nous avons modifie nos scripts dans ce but. Pour vous assurer que le contenu de l'objet XML a bien 
ete enregistre dans le fichier recepti on . xml , ouvrez ce fichier XML avec Dreamweaver. Son contenu 
doit etre identique au code ci-dessous. 

<?xml version="1.0" encoding="llTF-8"?> 

<ages> 

<pere prenom="Jean" nom="Dupond"> 
<enfant prenom="Paul "> 
<petitenfant prenom="Laurent"> 
9 

</petitenfant> 
</enf ant> 
</pere> 
</ages> 



A noter 

Selon la configuration du serveur, la methode send( ) sans second argument optionnel peut ne pas fonctionner. 
Dans ce cas, utilisez la methode sendAnl_oad( ) (voir la presentation de cette methode dans ce meme chapitre). 



Envoi d'un objet XML declenche par un bouton 

Dans le precedent script Flash, utilise pour l'envoi d'un objet XML avec la methode send( ), l'appel 
de la methode etait declenche par un evenement d'image (le passage de la tete de lecture sur l'image 
cle 1 du scenario principal). Des l'ouverture de l'application Flash dans le navigateur, l'objet etait 
envoye immediatement au script PHP recepti on . php. En pratique, l'envoi de l'objet XM est souvent 
declenche par d'autres types d'evenements (action sur un bouton, par exemple). D'autre part, dans 
l'exemple precedent, l'objet XML envoye ne peut pas etre modifie par l'utilisateur et il est difficile 
d'apprecier le fonctionnement du systeme d'un test a l'autre sans toucher au code du document FLA. 
Voici une variante de cette application de chargement qui permet d'envoyer un objet XML dont le 
contenu est construit a partir d'un texte saisi dans un champ de l'application Flash et envoye par une 
action sur un bouton OK. 

Modification du document Flash : send.fla 

Un bouton OK doit etre ajoute afin de declencher l'envoi apres la saisie du texte. Dans cette version, 
la methode send( ) est configuree avec la valeur _blank comme second argument afin d'afficher le 
contenu de l'objet XML dans une nouvelle fenetre des que le bouton est actionne. Un second bouton 
lienl_btn permettra d'ouvrir le fichier recepti on. xml dans une autre fenetre de navigateur pour 
s'assurer que l'enregistrement du fichier XML a bien ete effectue. 

1. Ouvrez le document send.fla cree precedemment et ajoutez trois caiques supplementaires : 
Texte, Bouton et Lien. 

2. Dans le caique Bouton, ajoutez un bouton OK et nommez son occurrence boutonl_btn. 
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3. Dans le caique Lien, ajoutez un second bouton qui permettra d'afficher le fichier XML dans une 
nouvelle fenetre du navigateur. Nommez l'occurrence de ce bouton 1 ienl_btn. 

4. Dans le caique Texte, ajoutez un champ de texte de saisie place a gauche du bouton OK. Nommez 
l'occurrence de ce bouton texteEnvoi_txt. 

5. Dans le caique Action, placez-vous dans l'image cle 1 et modifiez les lignes de code en gras dans 
le script ci-dessous. La methode parseXMLO permet d'initialiser l'objet envoi_xml avec un 
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//creation de l'objet envoi_xml 
var envol_xrnl ■ new XHL(); 

//conf iguration des parareetres de l'objet envoi_xn»l 
envoi_xml. ignoreWhite ■ true; 
errvoi_xml.contentType - "text/xml"; 

envoi_x»l.xnlDecl ■ '<?xml vera ion-" 1.0" encoding-"0TT-8"?> ' ; 

//affectation du contenu par defaut de l'objet envol_xt»l 
envoi_xinl .parseXHL ("-croessagocontenu par def aut</meaaage>") ; 

//gestion de 1' envoi avec la methode send() 

boutonl_btn.onReleaae - zunction() { 

envoi_xral . first Chi Id. f irstChi Id. nodeValue ■ texteEnvoi_tx 
envoi_xrnl .send ("reception. php", "_blan)c") ; 

); 

//gestion du lien pour voir le fichier XHL enregiatre 
lienlbtn.onPreaa - function!) ( 

getURL ("reception. xrel", ■ blank"); 
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Figure 20-10 

Creation de 1' application Flash permettant V envoi d'un objet XML grace a un bouton 



contenu par defaut. Le gestionnaire d'evenements onRel ease permet d'affecter le texte saisi dans 
le champ au contenu de 1' element message de l'objet envoi_xml (cible a l'aide du chemin 
envoi_xml .fi rstChild.fi rstChild.nodeVal ue) puis de declencher 1' envoi de ce meme objet vers 
le script recepti on . php. Enfin, les dernieres lignes permettent de gerer l'ouverture d'une nouvelle 
fenetre affichant le fichier recepti on . xml (voir figure 20-10): 

// Creation de l'objet envoi_xml 
var envoi_xml = new XMLO; 
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II Configuration des parametres de l'objet envoi_xml 
envoi__xml .ignoreWhite = true; 
envoi_xml .contentType = "text/xml"; 

envoi_xml .xml Decl = '<?xml version="1.0" encoding="UTF-8"?>' ; 
// Affectation du contenu par defaut de l'objet envoi_xml 
envoi_xml .parseXMK "<message>contenu par def aut</message>" ) ; 
// Gestion de 1 'envoi avec la methode sendO 
boutonl_btn.onRelease = functionO { 

envoi_xml . fi rstChild.fi rstChild.nodeValue = texteEnvoi_txt.text; 

envoi_xml . send ( "reception .php" , "_bl ank" ) ; 

}; 

// Gestion du lien pour voir le fichier XML enregistre 
lienl_btn.onPress = functionO { 
getURU "reception .xml " . "_bl ank" ) ; 

}; 

6. Enregistrez et publiez votre document Flash puis passez a la modification du script PHP. 
Modification du script PHP : reception. php 

Cote PHP, le script est identique au precedent, hormis le fait que F instruction echo( ) est de nouveau 
presente dans le script afin d'afficher la structure de l'objet XML dans une nouvelle fenetre apres 
action sur le bouton OK (voir les lignes en gras dans le code ci-dessous) : 

<?php 

header ( "Content-Type: text/xml " ) ; 
// 

$reception_xml = file_get_contents("php://input"); 

echo $reception_xml ; 
// 

$fp = fopen( "reception. xml " , "w"); 
fwrite($fp, $reception_xml ) ; 
fclose($fp) ; 
?> 

Test du systeme dans le Web local 

Enregistrez le nouveau fichier reception. php dans le meme repertoire que l'application Flash et 
passez dans le Web local pour tester son fonctionnement. Parcourez les repertoires pour localiser vos 
scripts et appelez le fichier HTML contenant l'application Flash. Saisissez une phrase dans la zone de 
texte et cliquez sur le bouton OK. Une nouvelle fenetre de navigateur s'ouvre et affiche le 
contenu de l'objet XML transmis au serveur. Pour vous assurer que ce contenu a bien ete enregistre 
dans le fichier reception. xml, cliquez sur le lien qui permet d'appeler la methode getURLC'recep- 
tion.xml", "_blank"). La fenetre de navigateur qui s'ouvre est identique a la precedente, mais son 
contenu XML est directement issu du fichier recepti on . xml enregistre sur le serveur. 
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Figure 20-1 1 

Test dans le Web local de I 'application permettant V envoi d'un objet XML grace d un bouton 

Methode sendAndLoad() 

Gestion de la connexion avec send And Load() 

Lorsque Ton appelle une methode sendAndLoad( ), une connexion client-serveur est ouverte durant la 
transmission des donnees de 1' application Flash vers le serveur (le nom du script PHP est parametre 
dans les arguments de la methode). Contrairement a la methode send( ) presentee precedemment, la 
connexion restera ouverte tant que les informations retournees par le script PHP a 1' application Flash 
ne seront pas receptionnees. On peut renvoyer un message a F application Flash pour signaler la 
bonne reception des donnees ou une erreur dans la transmission (voir figure 20-12). 

Figure 20-12 

Principe de V envoi et de la 
reception d'un document 
XML entre une application 
Flash et un script PHP a 
Vaide de la methode 
sendAndLoad( ) 



FLASH 



envoi xml 



chargement_xm 



Information XML 



sendAndLoad() 



Reponse XML 



Script PHP 

<?php 
?> 



fread() 



fwrite() 



.xml 
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Envoi et chargement d'objets XML 

Pour illustrer le fonctionnement de la methode sendAnLoad( ), nous allons creer une application Flash 
qui permettra de saisir un texte dans un champ de saisie, de le formater en XML puis de Fenvoyer a 
un script receptionReponse.php. Ce dernier enregistrera les elements XML recus dans un fichier 
reception.xml et retournera une reponse a F application Flash, elle aussi structuree en XML. Dans le 
script PHP, un test permettra de s'assurer du bon enregistrement XML. Si Fenregistrement s'est bien 
deroule, un premier message sera retourne a F application Flash. Dans le cas contraire, un message 
d'erreur informera Futilisateur du probleme. 

Creation du document Flash : sendAndLoad.fla 

1. Ouvrez un nouveau document Flash et enregistrez-le sous le nom sendAndLoad.fi a. 

2. Creez quatre caiques : Action, Bouton, Texte et Lien. 

3. Dans le caique Bouton, ajoutez un bouton OK et nommez son occurrence boutonl_btn. 

4. Dans le caique Lien, ajoutez un second bouton qui permettra d'afficher le fichier XML dans une 
nouvelle fenetre du navigateur. Nommez son occurrence 1 i enl_btn. 

5. Dans le caique Texte, ajoutez deux champs de texte. Le premier, place a gauche du bouton OK, 
sera de type champ de saisie. Nommez son occurrence texteEnvoi_txt. Le second, place en 
dessous, sera de type champ dynamique. Nommez son occurrence texteReponse_txt. 

6. Dans le caique Action, placez-vous dans F image cle 1 et saisissez les premieres lignes de code ci- 
dessous. Elles sont identiques a celles de Fexemple de la methode sendO. Elles permettent de 
creer un nouvel objet XML nomme envoi_xml et de configurer certaines de ses proprietes afin 
d'assurer son transfert vers le script PHP. La derniere ligne initialise Fobjet avec un contenu par 
defaut a Faide de la methode parseXMU ) (celui-ci sera ensuite remplace par le texte saisi dans le 
champ texteEnvoi_txt) (voir figure 20-13) : 

// Creation de 1 'objet envoi_xml 
var envoi_xml = new XMLO; 

// Configuration des parametres de 1 'objet envoi_xml 
envoi_xml .ignoreWhite = true; 
envoi_xml .contentType = "text/xml " ; 

envoi_xml .xml Decl = '<?xml version="1.0" encoding="UTF-8"?>' ; 
// Affectation du contenu par defaut de 1 'objet envoi_xtnl 
envoi_xml .parseXMK "<message>contenu par def aut</message>" ) ; 

7. A la suite de ce premier code, saisissez le script ci-dessous. Cette seconde partie de code est 
destinee a creer Fobjet XML chargement„xml qui receptionnera la reponse retournee par le script 
PHP. La propriete ignoreWhite de Fobjet est configured de telle sorte que Fanalyse des elements 
de Fobjet XML ne soit pas perturbee par d'eventuels espaces blancs places entre ses balises. 
Enfin, une methode de gestionnaire d'evenements est ajoutee afin de gerer le chargement des 
donnees et pour copier le contenu de F element XML retourne par le script PHP dans le champ 
dynamique texteReponse_txt : 

// Creation de 1 'objet chargement_xml 
var chargement_xml = new XMLO; 
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II Configuration des parametres de l'objet chargement_xml 
chargement_xml .ignoreWhite = true; 
// Gestionnaire de chargement 
chargement_xml .onLoad = function(succes) { 
if (succes) { 

texteReponse_txt.text = this.firstChild.firstChild.nodeValue; 

} else { 

texteReponse_txt.text = "Erreur FLASH de chargement "; 

} 

}; 
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1 //creation de l'objet envoi_xml 

2 var envoi_xral ■ new XHL(); 

3 //configuration des parametres de l'objet envoi_xml 

4 envoi_xml. ignoretfhite - true; 

5 envoi_xail.contentType ■ "text/xml"; 

$ envoi_xwl . xmlDecl • '<?xi»l version-"l .0" encoding-"U"rF-8"?>' ; 

7 //affectation du contenu par defaut de l'objet envoi_xml 

8 envoi_x»l.parseXRL("<message>contenu par def aut</message>") ; 

9 //creation de l'objet chargement xml 

10 var chargement_xml - new XHL(); 

11 //configuration des parametres de l'objet chargement_xml 
H charge7nent_xral . ignoreUhite - true; 

13 //gestionnaire de chargement 

14 chargeroent_xrol.onLoad - funct ion (success) ( 

15 if (success) ( 

16 texteReponse_txt.text - this . flrstChl Id. firstChild. nodi 

17 ) else < 

18 texteReponse_txt.text ■ "Erreur FLASH de chargement "; 

D 

20 }; 

21 //gestlon de 1' envoi et de la reponse avec la methode sendAndLc 

22 boutonl_btn.onRelease - function!) < 

23 envoi_xml.f irstChild.f irstChlld.nodeValue ■ texteEnvoi_txt. 

24 envoi_xml . sendAndLoad ( "recept lonPeponse. php", chargement_XR 

25 texteReponse_txt. text ■ "Chargement en cours..."; 



26 }; 
27 
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Figure 20-13 

Creation de I 'application Flash d' envoi et de chargement d'un objet XML : sendA ndLoad.fla 



8. Ajoutez le code ci-dessous dans la meme image cle. II contient un gestionnaire d'evenements 
attache au bouton OK qui permet d'inserer le contenu du champ de saisie texteEnvoi_txt a la 
place de 1' element par defaut configure precedemment. L'appel a la methode sendAndLoad C) 
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declenche ensuite l'envoi de l'objet XML envoi_xml vers le script receptionReponse.php ainsi 
que la recuperation de la reponse emise par le script serveur dans le second objet XML 
chargement_xml : 

// Gestion de l'envoi et de la reponse avec la methode sendAndLoad( ) 
boutonl_btn.onRelease = functionO { 

envoi_xml . fi rstChild.fi rstChild.nodeValue = texteEnvoi_txt.text; 

envoi_xml . sendAndLoad( "recepti on Reponse. php" , chargement_xml ) ; 

}; 

9. Un dernier script doit etre ajoute afin de controler Taction sur le bouton lienl_btn qui ouvrira une 
fenetre du navigateur dans laquelle sera affiche le fichier XML enregistre sur le serveur afin de 
controler le bon fonctionnement du systeme : 

// Gestion du lien pour voir le fichier XML enregistre 
lienl_btn.onPress = functionO { 
getURK "reception .xml " . "_bl ank" ) ; 

}; 

10. Enregistrez puis publiez votre document Flash avant de passer a la creation du fichier PHP. 
Creation du script PHP : receptionReponse.php 

Ouvrez un nouveau document PHP dans Dreamweaver et sauvegardez-le sous le nom recepti on- 
Recepti on . php dans le meme repertoire que le fichier SWF precedemment genere. 

Placez-vous dans la zone d'edition en mode code et ajoutez le code ci-dessous. Cette premiere partie 
de script est constituee d'une ligne generant un header de fichier compatible au type configure dans 
F application Flash (text/xml). Les autres lignes sont destinees a bloquer le cache du navigateur (voir 
figure 20-14) : 

<?php 

header ( "Content-Type: text/xml " ) ; 

// Blocage du cache 

headerC'Expires: Mon, 12 Jul 1995 02:00:00 GMT"); 

// Date d'expiration anterieure a la date actuelle 

headerC'Last-Modified: " . gmdateC'D, d M Y H:i:s") . " GMT"); 

// Indique de toujours modifier la date 

headert "Cache-Control : no-cache, must-revalidate"); 

// no-cache pour HTTP/1.1 

headert "Pragma : no-cache"); 

// no-cache pour HTTP/1.0 

A la suite de ce premier script, ajoutez la ligne de code ci-dessous. Elle permet de recuperer les 
donnees XML depuis le flux php://input (revoir si necessaire l'utilisation du flux php://input au 
debut de ce chapitre) : 

1 $reception_xml = f i 1 e_get_contents ("php: //input"); 
// Recuperation de l'objet XML dans le flux pp://input 
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2 header ("Content-Type: text/xal") ; 

//-—-—— Bloc age <tu Cache 

4 header ("Expires: Hon, 12 Jul 1995 02:00:00 CRT'); 

4 // Date d'expication anteneuce a la dace actuelle 

6 headet("Last-Hodifled: " . g»date(" n , d H Y H:i:s") . " GHT") ; 

7 // Indique de coujouts aodifiec la dace 

8 header ("Cache-Control: no-cache, aust-tevalidate") ; 
9. | // no-cache pour HTTP/1. 1 

10 header ("Pragma: no-cache"); 

. 11 // no-cache pouc HTTP/1.0 

13 «receptlon_x»l - Cile_9et_concencs("php://input"); 

14 //recuperation de I'objet XHL dans le flux pp: //input 

WM // 

16 ftp ■ f op en ("reception, xml", *V); //ouvertute du fichier reception. xml 

17 «reponae»"<?x»l version«\"1.0\" encodlnp;"\**tnT-8\ •*?>"* //diclartlon XJIL inttiale 

18 i£(6rvrite(«£p, $teception_x»l) ) /test si l'ecriture est correcte 

19 ( Sreponse.-"<ceponse> ok : l'enregistreaent est e££ectue </reponse>";) 

20 else //si pb d'ecriture » preparation du message d'erreur 

21 ( (reponse.«"<reponse> erreur : enreglstreaent non effectue </reponse>"; ) 

22 fceponse»utf8_encode((reponse);//codage de la reponse en UTT8 

23 peine $EtjWMtj//e.f tichage de la reponse destine a I'appn Flash 

24 6fclose((£p) ;//Ceraetuce du Cichler reception. xai 

25 ?> 
26 
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Figure 20-14 

Script dufichier receptionReponse.php cree avec Dreamweaver 



Enfin, ajoutez le script ci-dessous pour cloturer le programme PHP. II commence par l'ouverture du 
fichier XML dans lequel sera sauvegarde Fobjet XML envoye par l'application Flash. La ligne qui 
suit permet de preparer la variable $ reponse en lui affectant une declaration XML initiale, qui sera 
commune quel que soit le message retourne. La structure de choix i f permet de tester si l'ecriture du 
fichier s'est bien deroulee. 



A noter 

Le caractere @ place devant lafonction fwrite( ) evite que cette derniere n'affiche a I'ecran un message d'erreur 
genere automatiquement (sans cet ajout, le message d'erreur affiche par la fonction fwri te( ) perturberait le fonc- 
tionnement car il serait lui aussi retourne a l'application Flash comme reponse). 



Si l'ecriture dans le fichier reception. xml s'est deroulee correctement, un message le signalant est 
ajoute a la suite de la declaration XML initiale dans la variable $ reponse. Dans le cas contraire, e'est 
un message d'erreur qui prendra place dans cette meme variable. Apres la structure de choix, la fonction 
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utf8_encode( ) est appliquee a la variable $reponse afin de rendre son contenu conforme au format 
UTF8 avant qu'elle ne soit renvoyee a l'application Flash (grace a la fonction echo Sreponse). Enfin, 
la derniere ligne ferme le fichier reception. xml. 

// 

$fp = fopen( "reception. xml " , "w"); 
// Ouverture du fichier reception. xml 

$reponse="<?xml version=\"1.0\" encoding=\"UTF-8\"?>" ; // Declaration XML initiale 

if (@fwrite($fp, $reception_xml ) ) // Teste si l'ecriture est correcte 

{ $reponse.="<reponse> ok : 1 'enregistrement est effectue </reponse>" ; } 

else // Si probleme d'ecriture >> preparation du message d'erreur 

{ $reponse.="<reponse> erreur : enregistrement non effectue </reponse>" ; } 

$reponse=utf8_encode($reponse) ; // Codage de la reponse en UTF8 

echo $reponse; // Affichage de la reponse destinee a l'application Flash 

@f cl ose($fp) ; // Fermeture du fichier reception. xml 



A noter 

Un caractere @ est ajoute devant la fonction closeO (voir encadre concernant la fonction fwriteO). 



Test du systeme dans le Web local 

Enregistrez le fichier receptionReponse.php dans le meme repertoire que l'application Flash et 
passez dans le Web local pour tester son fonctionnement. Parcourez les repertoires pour localiser 
vos scripts et appelez le fichier HTML contenant l'application Flash. Saisissez une phrase dans la 
zone de texte et cliquez sur le bouton OK. L'objet XML envoi^xml est alors envoye au script PHP 
et le texte de reponse au format XML retourne par le script PHP est recupere dans l'objet XML 
chargement^xml puis s'affiche dans la zone de texte dynamique de l'application Flash. Si l'enregis- 
trement du fichier XML s'est bien deroule, le texte doit etre le suivant : « ok : 1' enregistrement est 
effectue ». Dans le cas contraire, un message d'erreur s'affiche dans cette meme zone de texte : 
« erreur : enregistrement non effectue. » Pour vous assurer que le contenu de l'objet XML a bien 
ete enregistre dans le fichier reception. xml, cliquez sur le lien qui permet d'appeler la methode 
getURLC'reception.xml ", "_blank"). Une fenetre de navigateur dont le contenu XML est directe- 
ment issu du fichier reception. xml enregistre sur le serveur s'ouvre et affiche le contenu de l'objet 
XML envoye precedemment (voir figure 20-15). 

Analyser un objet XML 

Verifier qu'un objet XML est bien forme 

La propriete status permet de detecter la presence d'une erreur d' analyse lors de la construction 
d'un objet XML (constructeur new XML( )), de l'utilisation de la methode d'analyse parseXMK ) ou du 
chargement d'un objet a l'aide des methodes loadO ou sendAndl_oad( ). L'utilisation de cette 
propriete permet de s'assurer que le document XML est bien forme, notamment lors du chargement 
d'un document XML exterieur, avant de passer a la phase de traitement. S'il n'y a pas d'erreur 
d'analyse, la propriete status est egale a la valeur 0. Dans le cas contraire, un nombre negatif lui est 
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Figure 20-15 

Test dans le Web local de V application d 'envoi et de chargement d'un objet XML 



affecte (voir tableau 20-8) et indique la nature de l'erreur rencontree. Dans l'exemple ci-dessous, les 
deux premieres analyses se sont effectuees sans erreur et la valeur retournee par status est egale a 0. 
Dans le dernier cas, la balise </pere> manque et le status le signale en affichant la valeur - 9. 

var monDoc_xml = new XML( ' <ages><pere prenom="Cl aude'Xenf ant prenom="Fabrice"/> 

**</pereX/ages>' ) ; 

trace( "monDoc_xml AVANT="+monDoc_xml ) ; 

// monDoc_xml AVANT=<ages><pere prenom="Cl aude'Xenfant prenom="Fabrice" /X/pereX/ages> 
traceCEtat de status apres la creation d'un objet XML="+monDoc_xml .status) ; 
// Etat de status apres la creation d'un objet XML=0 

monDoc_xml .parseXMK XagesXpere prenom=" Jean'Xenfant prenom="Alain"/X/pereX/ages>' ) ; 
traceCEtat de status apres 1 'utilisation de parseXMK )="+monDoc_xml .status) ; 
// Etat de status apres 1 'utilisation de parseXML()=0 

monDoc_xml .parseXMK XagesXpere prenom="Jean"Xenfant prenom="Alain"/X/ages>' ) ; 

// Dans le document XML ci-dessous, la balise fermante </pere> manque et son analyse renverra 

*»une erreur status de type -9 

traceCEtat de status apres 1 'utilisation avec erreur de parseXMK ) = "+monDoc_xml .status); 
// Etat de status apres 1 'utilisation avec erreur de parseXMK )=-9 



Tableau 20-8. Codes retournes par la propriete status 



Valeur de la propriete status 


Description 


0 


XML bien forme : document analyse sans erreur 


- 2 


Erreur : fermeture incorrecte d'une section CDATA 


- 3 


Erreur : terminaison incorrecte d'une declaration XML 


- 4 


Erreur : terminaison incorrecte d'une declaration DOCTYPE 
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Tableau 20-8. Codes retournes par la propriete status (suite) 



Valeur de la propriete status 


Description 




- 5 


Erreur : terminaison incorrecte d'un commentaire 




- 6 


Erreur : element XML mal forme 




- 7 


Erreur : memoire insuffisante pour analyser le document XML 




- 8 Erreur : mauvaise lecture d'une valeur d'attribut 


- 9 Erreur : absence d'une balise de fermeture 


- 10 


Erreur : absence d'une balise d'ouverture 





Verifier qu'un element a des enfants 

La methode hasChildNodes( ) verifie si un element a des enfants. Elle retourne la valeur true dans 
l'affirmative et la valeur false dans le cas contraire. Cette methode est souvent utilisee dans une 
expression de condition (structure de choix ou de boucle) afin de s'assurer qu'un element a des 
enfants avant d'effectuer un traitement. Dans l'exemple ci-dessous, nous utilisons la methode 
hasChildNodesC ) dans l'expression de condition d'une boucle while pour supprimer tous les enfants 
de l'element pere : 

var monDoc_xml = new XML( '<ages><pere prenom="Jean"Xenf ant prenom="Paul "/Xenf ant 
*»prenom="Al ain"/X/pere></ages> ' ) ; 
trace( "monDoc_xml AVANT="+monDoc_xml ) ; 

// monDoc_xml AVANTXagesXpere prenom="Jean"Xenfant prenom="Paul " /Xenfant 
*»prenom="Al ain" /X/pereX/ages> 

while(monDoc_xml . f i rstChi 1 d . f i rstChi 1 d .hasChi 1 dNodes ( ) ){ 
monDoc_xml . f i rstChi ld.fi rstChi ld.fi rstChi Id. removeNode( ) ; 
} 

// Etat du document apres la suppression 

trace( "monDoc_xml APRES="+monDoc_xml ) ; 

// monDoc_xml APRESXagesXpere prenom="Jean" /></ages> 



Cibler les elements XML 
Cibler un element enfant 

Pour cibler un element, il suffit de construire un chemin (en utilisant la syntaxe pointee) adapte au 
niveau de l'element a l'aide de la propriete f i rstChi 1 d (pour cibler le premier element d'un niveau) 
ou childNodes[n] (pour cibler un element d'ordre n du meme niveau). Une fois l'element cible, le 
nom de l'element correspondant est retourne si Ton ajoute la propriete nodeName a la fin du chemin. 
La propriete nodeVal ue permet de retourner la valeur de l'element (si elle existe, sinon la valeur nul 1 
est retournee). 

A noter 

La valeur est contenue dans un element a part entiere : il ne faut done pas oublier d'ajouter une propriete fi rst- 
Chi 1 d supplemental dans le chemin precedant la propriete nodeVal ue. 
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Le chemin ci-dessous cible F element enfant (en reference au contenu du document XML utilise dans 
l'exemple ci-apres) : 

monDoc_xml . f i rstChi ld.fi rstChi ld.fi rstChi 1 d 

Pour recuperer la valeur de ce meme element enfant, il faut ajouter f i rstChi 1 d .nodeVal ue a la suite 
de ce chemin, ce qui donne F expression suivante : 

monDoc_xml . f i rstChi ld.fi rstChi ld.fi rstChi ld.fi rstChi 1 d . nodeVal ue 

Pour illustrer F utilisation de ces proprietes, voici deux exemples de ciblage de balises et de valeurs 
d'elements. Dans le premier exemple, la propriete f i rstChi 1 d est utilisee car il n'y a qu'un seul element 
a chaque niveau. Dans le second exemple, la propriete childNodes[n] est utilisee afin d'acceder a 
differents elements d'ordre n d'un meme niveau. 

Exemple 1 (voir figure 20-16) : 

var monDoc_xml = new XML( ' <ages><pere prenom="Cl aude"Xenf ant prenom="Fabrice">35</enfant> 
**</pere></ages> ' ) ; 
trace("monDoc_xmlAVANT="+inonDoc_xml ) ; 

// monDoc_xml AVANT=<agesXpere prenom="Claude <enfant prenom="Fabrice">35</enfantX/pereX/ages> 
traceCCiblage de la balise de premier niveau ="+monDoc_xml .fi rstChi 1 d.nodeName) ; 
// Ciblage de la balise de premier niveau =ages 

traceCCiblage de la balise de second niveau ="+monDoc_xml .fi rstChild.fi rstChi 1 d.nodeName) ; 
// Ciblage de la balise de second niveau =pere 

traceCCiblage de la balise de troisieme niveau ="+monDoc_xml .firstChild.firstChild. 

1 rstChi 1 d . nodeName ) ; 
// Ciblage de la balise de troisieme niveau =enfant 

traceCCiblage de la valeur de la balise de troisieme niveau ="+monDoc_xml .firstChild. 

*f 1 rstChi 1 d . fi rstChi 1 d . fi rstChi 1 d . nodeVal ue ) ; 

// Ciblage de la valeur de la balise de troisieme niveau =35 
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Figure 20-16 

Construction d'un chemin ciblant un element enfant avec firstChild 
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Exemple 2 (voir figure 20-17) : 



var monDoc_xml = new XML( '<ages><pere prenom="Jean"Xenf ant prenom="Paul ">35</enfant> 
*»<enfant prenom="Alain">45</enfant></pere></ages>' ) ; 
trace( "monDoc_xml AVANT="+monDoc_xml ) ; 

// monDoc_xml AVANTXagesXpere prenom="Jean"Xenfant prenom="Paul ">35</enfant> 
*»<enfant prenom="Al ain">45</enfantX/pereX/ages> 

trace( "Cibl age de la valeur du premier enfant avec firstChild ="+monDoc_xml .firstChild. 

i rstChild.fi rstChi ld.fi rstChi 1 d . nodeVal ue) ; 
// Ciblage de la valeur du premier enfant avec firstChild =35 

trace( "Cibl age de la valeur du premier enfant avec childNodes[0] ="+monDoc_xml .firstChild. 

*firstChild.childNodes[0]. firstChild. nodeValue) ; 

// Ciblage de la valeur du premier enfant avec childNodes[0] =35 

trace( "Cibl age de la valeur du second enfant avec childNodes[l] ="+monDoc_xml .fi rstChild. 

*firstChild.childNodes[l]. firstChild. nodeValue); 

// Ciblage de la valeur du premier enfant avec childNodes[l] =45 
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Figure 20-17 

Construction d'un chemin ciblant un element enfant avec childNodesf] 



Cibler I'element parent 

Pour cibler I'element parent (un element ne peut avoir qu'un seul element parent), il suffit de construire 
un chemin (en utilisant la syntaxe pointee) qui cible I'element enfant concerne et de lui ajouter la 
propriete parentNode. Voici un exemple de ciblage de I'element parent de I'element enfant <enfant 
prenom="Fabrice">35</enfant> (voir - figure 20-18) : 

var monDoc_xml = new XML( XagesXpere prenom="Cl aude"Xenfant prenom="Fabrice">35</enfant> 
*»</pereX/ages> ' ) ; 
trace( "monDoc_xml AVANT="+monDoc_xml ) ; 
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II monDoc_xml AVANTXagesXpere prenom="Claude <enfant prenom="Fabrice">35</enfantX/pereX/ages> 
var pointeurEnfant:Object =monDoc_xml .f irstChild.fi rstChild.fi rstChild ; 
// Pointeur element <enfant> 

traceCCiblage du nom de balise de 1 'element enfant ="+pointeurEnfant. nodeName) ; 
// Ciblage du nom de balise de 1 'element enfant =enfant 
traceCCiblage de 1 'element parent ="+pointeurEnfant. parentNode) ; 
// Ciblage de 1 'element parent (le contenu de 1 'element) 

// Ciblage de 1 'element parent = <pere prenom="Cl aude"Xenfant prenom="Fabrice"> 
*-35</enfantX/pere> 

traceCCiblage du nom de balise de 1 'element parent ="+pointeurEnfant. parentNode. nodeName) ; 

// Ciblage du nom de balise de 1 'element parent 

// Ciblage du nom de balise de l'element parent = pere 
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Figure 20-18 

Construction d'un chemin cihlont un element parent avec parentNode 
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Cibler I'attribut d'un element 

II existe deux manieres de cibler Fattribut d'un element a l'aide de la propriete attributes. La 
premiere utilise la syntaxe pointee exploitee traditionnellement en POO (exemple : attribu- 
tes.nomAttribut). La seconde utilise la syntaxe classique d'un tableau de variable (exemple : attri- 
butes["nomAttribut"]). Dans l'exemple ci-dessous, ces deux syntaxes sont utilisees successivement 
pour amcher Fattribut de l'element pere de Fobjet XML (dont la valeur est CI aude) (voir figure 20-19) : 

var monDoc_xml = new XML( ' <ages><pere prenom="Cl aude"Xenfant prenom="Fabrice"/X/pere> 
*-</ages>') ; 

trace( "monDoc_xml AVANT="+monDoc_xml ) ; 

// monDoc_xml AVANT=<agesXpere prenom="Cl aude"Xenfant prenom="Fabrice" /X/pereX/ages> 
trace( "Methode 1 pour cibler I'attribut de pere [0] ="+monDoc_xml .firstChild. 
*»fi rstChild. attributes. prenom) ; 

// Methode 1 pour cibler I'attribut de pere [0] =Claude 
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trace( "Methode 2 pour cibler 1'attribut de pere [0] ="+monDoc_xml .firstChild.fi rstChi Id. 
*»attributes["prenom"]) ; 

// Methode 2 pour cibler 1'attribut de pere [0] =Claude 
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Figure 20-19 

Construction d'un chemin ciblant 1'attribut d'un element avec attributes 



Traiter les elements d'un objet XML 

Traiter tous les elements d'un meme niveau 

Pour traiter tous les elements d'un meme niveau, il faut parcourir les elements et leur valeur a Faide 
d'une boucle. Trois techniques peuvent etre exploiters pour parcourir les elements d'un meme 
niveau. La premiere s'appuie sur la propriete childNodes couplee avec une boucle for. Les deux 
autres utilisent les proprietes nextSi bl i ng ou previ ousSi bl i ng couplees avec une boucle while. 

Parcours des elements avec childNodes 

Grace a la methode childNodes qui permet d'acceder sous forme d'un tableau childNodes[n] a tous 
les elements enfants contenu dans un meme element pere, il est possible de parcourir (et done de trai- 
ter) tous les elements d'un meme niveau. En effet, childNodes[n] etant un tableau, il est possible 
d'acceder a sa propriete length arm de conditionner une boucle. L'exemple ci-dessous illustre cette 
technique : 

var monDoc_xml = new XML( ' <ages><pere prenom="Jean"Xenf ant >35</enfantXenfant >42</enfant> 
*<enfant >38</enfantX/pereX/ages> ' ) ; 
tracet "monDoc_xml AVANT="+monDoc_xml ) ; 

// monDoc_xml AVANTXagesXpere prenom="Jean"Xenfant>35</enf antXenf ant>42 
*»</enf antXenf ant>38</enfantX/pereX/ages> 
var pointeurPere:Object =monDoc_xml .firstChild.fi rstChild ; 
// Pointeur element <pere> 
trace("pointeurPere= "+pointeurPere) ; 

// pointeurPere= <pere prenom="Jean"Xenfant>35</enf antXenf ant>42</enf antXenf ant> 
*38</enfantX/pere> 

var nbreEl ementPere =pointeurPere. childNodes. length ; 
// nombre d'elements enfants de 1 'element pere, soient 3 
trace( "nbreElementPere = "+nbreElementPere) ; 



XML et Flash 

Chapitre 20 



II nbreEl ementPere = 3 

var nomBal i se:String=pointeurPere.nodeName; 
// nom de la balise pointee, soit pere 
trace( "nomBal i se = "+nomBal ise) ; 
// nomBalise = pere 

// Boucle de recuperation des elements 

for (var n:Number =0; n<pointeurPere.childNodes. length; n++) { 
traceC'Element enfant "+n+" est egal a "+ pointeurPere.childNodes[n] . 
^firstChild.nodeValue); 
} 

/* 

Element enfant 0 est egal a 35 
Element enfant 1 est egal a 42 
Element enfant 2 est egal a 38 
*/ 

Parcours des elements avec nextSibling 

Contrairement a la technique precedente qui permet de parcourir tous les elements enfants d'un 
element pere, nous allons cibler le premier element d'un niveau pour parcourir ensuite tous les 
elements freres du meme niveau. Pour mettre en ceuvre cette technique, nous utiliserons la propriete 
nextSibl ing - qui permet de deplacer un pointeur au frere suivant - et nous l'integrerons dans une 
boucle while : 

var monDoc_xml = new XML( ' <ages><pere prenom="Jean"Xenfant >35</enf antXenf ant > 
*-42</enfantXenfant >38</enf ant></pere></ages> ' ) ; 
trace( "monDoc_xml AVANT="+monDoc_xml ) ; 

// monDoc_xml AVANTXagesXpere prenom="Jean"Xenf ant>35</enfant><enf ant>42</enfant><enfant> 
*-38</enfantX/pereX/ages> 

var pointeurPremierEnfantiObject =monDoc_xml .firstChild.firstChild.firstChild ; 
// Pointeur premier element <enfant> 
t race ( "pointeur Premier Enfant^ "+pointeur Premier Enfant) ; 
// PointeurPremierEnfant= <enf ant>35</enf ant> 
var n:Number =0;//init du compteur d'element 
// Boucle de parcours des elements freres 
while (pointeurPremierEnfant!= null) { 
traceC'Element enfant "+nbreAttribut+" est egal a "+ pointeurPremierEnfant. 
^■firstChild.nodeValue) ; 

pointeurPremierEnfant^pointeur Premier Enfant. nextSibl ing; 
// Deplace le pointeur sur 1 'element suivant 
n++; // Incremente le compteur d'elements 
} 

/* 

Element enfant 0 est egal a 35 
Element enfant 1 est egal a 42 
Element enfant 2 est egal a 38 
*/ 
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Parcours des elements avec previousSibling 

Cette derniere technique est identique a la precedente, si ce n'est que nous allons parcourir les diffe- 
rents freres d'un meme niveau en partant du dernier et en deplacant le pointeur au frere precedent (a 
Faide de la propriete previ ousSi bl i ng) a chaque tour de boucle : 

var monDoc_xml = new XML( XagesXpere prenom="Jean"Xenf ant >35</enf antXenf ant >42 
*-</enfantXenfant >38</enfantX/pereX/ages>' ) ; 
trace( "monDoc_xml AVANT="+monDoc_xml ) ; 

// monDoc_xml AVANTXagesXpere prenom="Jean"Xenfant>35</enf antXenfant> 
*42</enfantXenfant>38</enfantX/pereX/ages> 

var pointeurDernierEnfant:Object =monDoc_xml .firstChild.fi rstChild.lastChild ; 

// Pointeur dernier element <enfant> 

trace( " pointeur Dernier Enf an t= "+pointeurDernier Enfant) ; 

//pointeur Dernier Enf ant= <enf ant>38</enfant> 

var n:Number =monDoc_xml .firstChild.firstChild.childNodes. length ; 

// Init du compteur d'elements 

trace( "nombre de freres ="+n); 

// Nombre de freres =3 

// Boucle de parcours des elements freres 

while (pointeurDernierEnfant!= null) { 

traceC'Element enfant "+n+" est egal a "+ pointeurDernierEnfant.fi rstChild.nodeVal ue) ; 

pointeur Dernier Enf ant=pointeurDernier Enf ant. previ ousSibl ing; 

// Deplace le pointeur sur 1 'element precedent 

n--; // Decremente le compteur d'elements 

} 

/* 

Element enfant 3 est egal a 38 
Element enfant 2 est egal a 42 
Element enfant 1 est egal a 35 
*/ 

Traiter tous les attributs d'un element 

Contrairement aux differents elements d'un meme niveau, les attributs d'un meme element ne sont 
pas contenus dans un tableau indice mais dans un objet attributes. On peut egalement utiliser une 
boule for/in (boucle destinee a parcourir les proprietes d'un objet ; revoir si besoin le chapitre 10) 
comme le montre l'exemple ci-dessous, dans lequel sont affiches tous les attributs de l'element pere 
(nom et prenom dans cet exemple) : 

var monDoc_xml = new XML( '<ages><pere nom="Dupond" prenom="Jean"Xenfant >35</enfant> 

*»</pereX/ages> ' ) ; 

trace( "monDoc_xml AVANT="+monDoc_xml ) ; 

// monDoc_xml AVANTXagesXpere nom="Dupond" prenom="Jean"Xenfant>35</enfantX/pereX/ages> 

var nbreAttribut:Number =0;//init du compteur d'attribut 

var pointeurPere:Object =monDoc_xml .firstChild.childNodes[0] ; 

// Pointeur element <pere> 

var nomBal ise:String=pointeurPere.nodeName; 

//nom de la balise <pere> soit : pere 

// Boucle de recuperation des attributs 

for (var nomAttribut:String in pointeurPere. attributes) { 

traceCL'attribut "+nomAttribut+" est egal a "+ pointeurPere. attributes[nomAttribut]) ; 

nbreAttribut++; // Incremente le compteur d'attributs 
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) 

/* 

L'attribut nom est egal a Dupond 
L'attribut prenom est egal a Jean 
*/ 

traceCL'element <"+nomBal i se+"> a "+nbreAttribut+" attributs"); 
// L'element <pere> a 2 attributs 



Formater et structurer un objet XML 

Inserer ou remplacer tout le contenu d'un objet XML 

Pour remplacer tout le contenu d'un objet XML (balises et valeurs de tous les elements de l'objet), il 
est possible d'utiliser la methode parseXMK "contenuObjetXml " ). Cette methode doit etre appliquee a 
un objet XML prealablement cree. Si l'objet XML a ete cree vide, le contenu sera simplement insere 
dans l'objet, sinon il remplacera tous les elements qu'il contient. 

L'exemple ci-dessous montre comment remplacer le contenu de l'objet monDoc_xml en utilisant la 
methode parseXML( ) : 

var monDoc_xml = new XML( '<ages><pere>42</pere></ages>' ) ; 

trace( "monDoc_xml AVANT="+monDoc_xml ) ; 

// monDoc_xml AVANT=<agesXpere>42</pereX/ages> 

monDoc_xml .parseXMK ' <ages><pere nom=" Dupond" >35</pereX/ages>' ) ; 

tracet "monDoc_xmlAPRES="+monDoc_xiTil ) ; 

// monDoc_xml APRESXagesXpere nom="Dupond">35</pereX/ages> 

Supprimer un objet XML 

Pour supprimer un objet XML, il faut appliquer l'instruction del ete a l'objet XML lui-meme (cible 
par monDoc_xml dans l'exemple ci-dessous). Avec cette methode, l'objet XML est definitivement 
supprime, ce qui permet de liberer de l'espace memoire. L'exemple ci-dessous montre comment 
supprimer l'objet monDoc_xml : 

var monDoc_xml = new XML( ' <agesXpere>42</pereX/ages> ' ) ; 

trace( "monDoc_xml AVANT="+monDoc_xinl ) ; 

// monDoc_xml AVANT=<agesXpere>42</pereX/ages> 

delete monDoc_xml ; 

trace( "monDoc_xml APRES="+monDoc_xinl ) ; 
// monDoc_xmlAPRES=undefined 

Modifier la valeur d'un element XML 

Pour modifier la valeur d'un element contenu dans un objet XML, il suffit d'affecter la nouvelle 
valeur en utilisant le chemin cible de l'element termine par la propriete nodeVal ue (revoir si neces- 
saire le ciblage d'un element). L'exemple ci-dessous montre comment remplacer la valeur de 
l'element enfant (soit initialement 35) par une nouvelle valeur (42) : 

var monDoc_xml = new XML( '<ages><pere prenom=" Jean"Xenfant prenom="Paul ">35</enf ant> 
**</pereX/ages> ' ) ; 
tracet "monDoc_xml AVANT="+monDoc_xml ) ; 
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II monDoc_xmlAVANT=<ages><pere prenom="Jean"Xenfant prenom="Paul ">35</enfantX/pereX/ages> 

trace("Ciblage de la valeur du premier enfant avant modification ="+monDoc_xml .firstChild. 

*f 1 rstChi ld.fi rstChi 1 d . f i rstChi 1 d . nodeVal ue ) ; 

// Ciblage de la valeur du premier enfant avant modification =35 

monDoc_xml . fi rstChild.fi rstChi ld.fi rstChi Id. fi rstChi ld.nodeValue="42"; 

// Affectation de la nouvelle valeur a 1 'element enfant 

traceCCiblage de la valeur du premier enfant apres modification ="+monDoc_xml .firstChild. 

*f i rstChi ld.fi rstChi ld.fi rstChi 1 d. nodeVal ue ) ; 

// Ciblage de la valeur du premier enfant apres modification =42 

Modifier le nom de balise d'un element XML 

Pour modifier le nom de la balise d'un element contenu dans un objet XML, il suffit d'affecter la 
nouvelle valeur en utilisant le chemin cible de l'element, termine par la propriete nodeName (revoir si 
besoin le ciblage d'un element). L'exemple ci-dessous montre comment modifier le nom d'une 
balise : 

var monDoc_xml = new XML( ' <ages><pere prenom="Jean"Xenfant prenom="Paul ">35</enfantX/pere> 
*</ages>') ; 

trace( "monDoc_xml AVANT="+monDoc„xml ) ; 

// monDoc_xmlAVANT=<ages><pere prenom="Jean"Xenfant prenom="Paul ">35</enfantX/pereX/ages> 
traceCCiblage du nom de la balise avant modification ="+monDoc_xml .firstChild. 
*f irstChild.fi rstChi Id. nodeName ) ; 

// Ciblage du nom de la balise avant modification =enfant 
monDoc_xml . fi rstChi ld.fi rstChi ld.fi rstChi ld.nodeName="fi Is"; 
// Affectation du nouveau nom de la balise : fils 

traceCCiblage du nom de la balise apres modification ="+monDoc_xml .firstChild. firstChild. 
^•firstChild. nodeName) ; 

// Ciblage du nom de la balise apres modification =fils 
trace( "monDoc_xml APRES="+monDoc_xml ) ; 

// monDoc_xml APRESXagesXpere prenom="Jean"Xf i 1 s prenom="Paul ">35</fi 1 sX/pereX/ages> 

Creer des elements d'objet XML 

Pour creer les elements d'un objet XML (balise et valeur), il faut utiliser les methodes createEle- 
mentCnomElemXml ") (pour creer la balise de l'element) et createTextNode( "val eurEl emXml " ) (pour 
creer la valeur contenue dans l'element). Une fois l'element et sa valeur crees, il faut ensuite utiliser 
la methode appendChildO pour affecter la valeur a l'element (elemPere.appendChild(elemTexte)), 
puis inserer l'ensemble dans l'objet XML au niveau de votre choix (monDoc_xml . f i rstChi 1 d . append- 
Child(elemPere)). 

L'exemple ci-dessous montre comment creer un nouvel element <pere> dont la valeur est 35 et 
comment l'inserer dans l'objet XML : 

var monDoc_xml = new XML( '<agesXpere>42</pereX/ages>' ) ; 
trace( "monDoc_xml AVANT="+monDoc_xml ) ; 
// monDoc_xml AVANT=<agesXpere>42</pereX/ages> 
elemPere=monDoc_xml .create El ement( "pere" ) ; //<pere /> 
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el emTexte=monDoc_xml .createTextNode( "35" ) ;//35 
el emPere.appendChi 1 d(el emTexte) ; //<pere>35</pere> 
monDoc_xml .firstChild.appendChild(elemPere) ; 
trace( "monDoc_xml APRES="+monDoc_xml ) ; 

// monDoc_xml APRES=<ages><pere>42</pereXpere>35</pereX/ages> 

Copier un element d'objet XML 

Pour ajouter un element et sa valeur au sein d'un objet XML existant, on peut utiliser la methode 
cl oneNode( ), qui permet de copier un element existant. II suffit ensuite de modifier sa valeur ou ses 
attributs pour le personnaliser avant de l'inserer dans le document XML dont il est issu : 

var monDoc_xml = new XML( '<ages><pere>42</pere></ages>' ) ; 

trace( "monDoc_xml AVANT="+monDoc_xinl ) ; 

// monDoc_xml AVANT=<agesXpere>42</pereX/ages> 

el emPere=monDoc_xml . firstChi ld.fi rstChild.cloneNode (true); 

// <pere>42</pere> 

elemPere.fi rstChild.nodeVal ue="35"; 

// <pere>35</pere> 

monDoc_xml .firstChild.appendChild(eleinPere) ; 
trace( "monDoc_xml APRES="+monDoc_xinl ) ; 

// monDoc_xml APRES=<agesXpere>42</pereXpere>35</pereX/ages> 

Supprimer un element d'un objet XML 

Pour supprimer un element d'objet XML, il faut lui appliquer la methode removeNode( ) (cet element 
est cible par monDoc^xml .firstChild.childNodes[l] dans l'exemple ci-dessous). Cette methode 
supprime l'element cible mais aussi toute sa filiation (enfants, petits-enfants...). 



Attention ! 

Cette methode permet de supprimer tous les elements enfants d'un objet XML mais elle ne supprime pas I'objet 
XML lui-meme (il faut pour ce faire lui appliquer I'instruction del ete). 



Dans l'exemple ci-dessous le second element enfant de I'objet (<pere>35</pere>) est supprime de la 
hierarchie de I'objet XML : 

var monDoc_xml = new XML( ' <agesXpere>42</pereXpere>35</pereX/ages> ' ) ; 
trace("monDoc_xmlAVANT="+monDoc_xml ) ; 

// monDoc_xml AVANT=<agesXpere>42</pereXpere>35</pereX/ages> 

monDoc_xml . f i rstChi Id. childNodes[l] . removeNode( ) ; 

trace( "monDoc_xml APRES="+inonDoc_xml ) ; 

// monDoc_xml APRES=<agesXpere>42</pereX/ages> 

Deplacer un element d'un objet XML 

Pour deplacer des elements dans une hierarchie XML, on peut utiliser la methode appendChild( ). 
Cette methode (voir ci-dessus) permet d' ajouter un element enfant a un element pere. Pour effectuer 
un deplacement au lieu d'un ajout, il suffit que l'element enfant indique dans l'argument de la 
methode soit present dans la hierarchie de I'objet XML. L'element enfant sera alors supprime de son 
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emplacement actuel et recree en tant qu' enfant de V element pere prefixant la methode (soit 
monDoc_xml .firstChild.childNodes[l] dans l'exemple ci-dessous). 

Dans l'exemple ci-dessous, on desire modifier la paternite de Fenfant Fabrice et l'affecter au pere 
Thierry (alors qu'initialement Fabrice est l'enfant de Claude) : 

var monDoc_xml = new XML( '<ages><pere prenom="Cl aude"Xenfant prenom="Fabrice"/X/pere> 
*»<pere prenom="Thierry" /></ages>') ; 
trace( "monDoc_xml AVANT="+monDoc_xml ) ; 

// monDoc_xml AVANTXagesXpere prenom="Cl aude"Xenfant prenom="Fabrice" /X/pere> 
*»<pere prenom="Thierry" /></ages> 

trace("element pere cible ="+monDoc_xml .firstChild.childNodes[l]); 
// element pere cible = <pere prenom="Thierry" /> 

trace( "element enfant source = "+monDoc_xml . f i rstChl 1 d . chi 1 dNodes[0] . f i rstChi Id); 

// L'element enfant source = <enfant prenom=" Fabrice" /> sera deplace car il existe deja dans 

^►la hierarchie de 1'objet XML 

monDoc_xml .firstChild.childNodes[l].appendChild(monDoc_xml .firstChild.childNodes[0]. 
*fi rstChi Id); 

trace( "monDoc_xml APRES="+monDoc_xml ) ; 

// monDoc_xml APRESXagesXpere prenom="Cl aude" /Xpere prenom="Thierry"> 
*»<enfant prenom="Fabri ce" /X/pereX/ages> 

Creer ou supprimer I'attribut d'un element 

Pour creer un attribut, il suffit de lui affecter une valeur. II sera initialise avec cette valeur. La suppres- 
sion d'un attribut est aussi simple : il suffit d'utiliser l'instruction delete, suivie du chemin ciblant 
l'element a supprimer. 

Dans l'exemple ci-dessous, dans un premier temps, I'attribut nom est ajoute a l'element <pere>, puis 
initialise a la valeur Dupond. Dans un second temps, ce meme attribut est supprime de son element afin 
d'obtenir une structure identique a celle du debut du traitement : 

var monDoc_xml = new XML( XagesXpere prenom="Cl aude"Xenfant /X/pereX/ages> ' ) ; 
trace( "monDoc_xml AVANT="+monDoc„xml ) ; 

// monDoc_xml AVANT = <ages><pere prenom="Cl aude'Xenfant /X/pereX/ages> 
monDoc_xml .firstChild.firstChild.attributes.nom="Dupond"; 
// Ajout de I'attribut nom initialise avec la valeur Dupond 
trace( "monDoc_xml APRESajout="+monDoc_xml ) ; 

// monDoc_xml APRESajoutXagesXpere nom="Dupond" prenom="Cl aude"Xenfant /X/pereX/ages> 
delete monDoc_xml .fi rstChi ld.fi rstChi Id . attributes. nom; 
// Suppression de I'attribut precedemment cree 
trace( "monDoc_xml APRESsupp="+monDoc_xml ) ; 

// monDoc_xml APRESsupp XagesXpere prenom="Cl aude"Xenf ant /X/pereX/ages> 
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Utilisation des objets XMLSocket 

Les objets XMLSocket de Flash permettent de communiquer avec un serveur socket grace a une 
connexion persistante. Un serveur socket peut accepter de multiples connexions en meme temps et 
renvoyer une information identique a tous les clients connectes. La mise en ceuvre d'objets XMLSoc- 
ket couples avec un serveur socket permet de creer des applications capables de reagir en temps reel 
comme des plates-formes de dialogue en ligne (chat) ou tout type de jeu en reseau multijoueur. 

Dans ce chapitre, nous presenterons uniquement la syntaxe du constructeur XMLSocket ainsi que ses 
methodes et ses gestionnaires. Cependant, ann d'illustrer le fonctionnement d'un objet XMLSocket 
et d'un serveur socket, une application simple de dialogue en ligne est developpee dans le 
chapitre 22. 
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Figure 20-20 

Principe des connexions entre un serveur socket et des applications clients Flash : lorsque le client A envoie un 
message XML au serveur socket, celui-ci le receptionne et le diffuse a tous les clients connectes. Le 
gestionnaire d'evenements onXML de chaque client est alors invoque et se charge de recuperer et de traiter 
cette nouvelle information. 
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La classe XMLSocket 

La classe XMLsocket doit etre creee avant de communiquer avec un serveur socket. Une fois 
Finstance de la classe creee (objet XMLSocket cree avec new XMLSocket ( )), on peut ensuite utiliser 
ses methodes - connects ), sendO, closeO - et ses gestionnaires d'evenements - onConnect( ), 
onDataO, onCloseO etonXMLO -pourse connecter puis communiquer avec un serveur socket. 

Tableau 20-9. Syntaxe du constructeur de la classe XMLSocket 

La classe XMLsocket permetde creer des objets XMLSocket (monObjet_xml socket) et d'utiliser ses methodes etses gestion- 
naires pour communiquer avec un serveur socket. 

Creation d'un objet a I'aide du constructeur : 

var monObjet_xml socket = new XMLSocketO 



Methodes des objets XMLSocket 

Tableau 20-10. Methodes de la classe XMLSocket 



Methodes 

monObjet_xml socket .connect ( "hote" .port) 

Ouvre une connexion entre le serveur socket et I'objet monObjet_xml socket. 
Cette methode retourne une valeur booleenne true en cas de succes ou false 
dans le cas contraire. Apres la tentative de connexion, le gestionnaire onConnectt ) 
est ensuite invoque. 
Exemple : 

monObjet_xml socket .connect ( "1 ocal host" ,22222) 
monObjet_xml socket .send (el em_xml node) 

Transmet au format XML les informations de I'element el em_xml node au serveur 
socket prealablement connecte avec monObjet_xml socket. En cas de reponse 
du serveur socket, le gestionnaire onXMLt ) sera invoque. 
Exemple 1 : 

monObjet_xml socket .send ( "<ages>52</ages>" ) ; 
Exemple 2 : 

var monDoc_xml = new XML( "<ages>52</ages>" ) ; 
monObjet_xml socket. send(monDoc_xml ) ; 



Definitions des parametres 

hote : adresse absolue (exemple: www. ser- 
veur. com) ou adresse IP (exemple: 
213.186.39.111) specifiant ou se trouve I'hote 
auquel on desire se connecter. Si I'hote est sur la 
meme machine que I'application Flash, il est pos- 
sible d'indiquer "local host" comme argument, 
port : nombre entier correspondant a un numero 
de port superieur ou egal a 1 024. Ce numero est 
specifique au serveur socket utilise et doit corres- 
pondre au port d'ecoute de ce dernier. 
elem_xmlnode : occurrence de la classe XML- 
node ou chaine contenant du texte au format XML. 
La classe XML etant une sous-classe de la super- 
classe interne XMLnode, cet element peut etre une 
occurrence de la classe XML (done un objet XML 
habituellement nomme monObjet_xml dans les 
autres exemples) ou un simple element XML issu 
de la hierarchie de cet objet. 



monObjet_xml socket .cl ose( ) 

Termine une connexion ouverte entre le serveur socket et I'objet 
monObjet_xml socket. A noter : La methode cl ose( ) ne declenche pas le ges- 
tionnaire onCl ose( ). En effet, ce dernier est declenche par une interruption de 
la connexion initiee par le serveur de socket lui-meme. 
Exemple : 

monObjet_xmlsocket.close(); 
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Tableau 20-11. Gestionnaires d'evenements de la classe XMLSocket 



Gestionnaires d'evenements 

monObjet_xml socket. onConnect = function (succes) ( 
// Mettre ici vos instructions de traitement } 

Le gestionnaire d'evenements onConnect est invoque lors d'une tentative de connexion initiee 
par I'appel de la methode connect ( ). Si la connexion est etablie correctement, le parametre 
succes est affecte a true et dans le cas contraire a f al se. 
Exemple : 

monDoc_xml socket .onConnect=f unction (succes) { 
if ( !succes){ 

erreur_txt.text="erreur de connexion"; 

} 

} 

monObjet_xml socket. onData = function (src) { 
// Mettre ici vos instructions } 

Le gestionnaire d'evenements onData ( ) est invoque des qu'une information est envoyee par 
le serveur socket a I'objet monObjet_xml socket. Par defaut, ce gestionnaire convertit I'infor- 
mation recue (src) en un objet XML qu'il transmetautomatiquementau gestionnaire onXMK ). 
En pratique, ce gestionnaire est rarement utilise sauf dans certains cas pour intercepter les 
informations avant qu'elles ne soient traitees par le gestionnaire onXML( ). 



Definitions des parametres 

src : chaTne contenant le code source 
des elements XML envoye par le ser- 
veur socket. 

succes : ce parametre indique si 
I'operation de connexion s'est deroulee 
avec succes (true) ou non (f al se). 
el em_xml node : occurence de la 
classe XMLnode ou chalne contenant 
du texte au format XML. La classe 
XML etant une sous-classe de la 
super classe interne XMLnode, cet 
element peut etre une occurence de 
la classe XML (done un objet XML 
habituellement nomme monObjet_xml 
dans les autres exemples) ou un ele- 
ment XML issu de la hierarchie de cet 
objet. 



monObjet_xml socket. onXML = function (elem_xmlnode) { 
// Mettre ici vos instructions de traitement } 

Le gestionnaire d'evenements onXMLO est invoque des qu'une information complete est 
receptionnee en provenance du serveur socket. Cette information est alors analysee puis 
transmise par I'argument el em_xml node. En pratique, ce gestionnaire permet de demarrer un 
traitement des reception d'une nouvelle information du serveur socket. 
Exemple : 

monDoc_xml socket .onXML=f uncti on(message_xml ) { 
message_txt .text=message_xml .firstChild.fi rstChil d.nodeVal ue ; 
) 



monObjet_xml socket .onCl ose = function () { 
//mettre ici vos instructions de traitement } 

Le gestionnaire d'evenements onCl ose( ) est invoque des que la connexion estfermee par le 
serveur socket. En pratique, ce gestionnaire est utilise pour declencher un traitement en cas 
de deconnexion externe du socket. 
Exemple : 

monDoc_xml socket .onCl ose=f uncti on ( ) { 

avertissement_txt.text="La connexion a ete interrompue par le serveur"; 
) 

} 



Application des objets XMLsocket 

Pour illustrer I'utilisation des objets XMLsocket, une application de dialogue en ligne (chat) est 
presentee a la fin du chapitre 22. 
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La lecture et 1' analyse d'un fichier XML avec PHP peuvent etre mises en ceuvre a l'aide de 
plusieurs techniques differentes (SAX, DOM, XSLT...). Cependant, la presentation de ces diffe- 
rentes techniques necessiterait a elle seule un ouvrage. Dans le cadre de ce livre, nous nous limi- 
terons done a l'analyseur syntaxique XML de PHP (1' extension xml), simple et frequemment 
disponible sur les infrastructures serveur PHP 4 courantes. Nous verrons aussi comment gerer 
tres simplement un document XML a l'aide du module SimpleXml disponible par defaut sur les 
serveur PHP 5. 

Analyseur syntaxique XML de PHP 4 

L'extension xml de PHP 

Avant de commencer, assurez-vous que l'extension xml est bien installee sur votre infrastructure 
serveur. La suite Wamp 5 comprend par defaut l'extension xml et simpleXml (voir figure 21-1). Pour 
savoir si l'extension xml est installee sur votre serveur distant, inserez la fonction phpi nfo( ) dans une 
page de votre serveur afin de controler que les fonctionnalites xml sont bien activees (voir figure 21-2). 
Notez que pour afficher la page phpinfo de votre serveur local Wamp 5, il suffit de cliquer sur le lien 
de meme nom accessible depuis la page d'accueil du localhost. 
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Lafonction phpinfo() permet de verifier que V extension xml est correctement activee sur voire serveur 
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Creation et utilisation d'un anaiyseur xmi 

Une fois F extension xml prealablement installee sur votre serveur PHP, vous pourrez creer un anaiy- 
seur XML puis definir des gestionnaires d'evenements et des methodes de traitement XML afin 
d' analyser des documents XML. 

Pour analyser un document XML, il faut d'abord creer un objet anaiyseur XML a l'aide de la fonc- 
tion xml_parser_create( ) (voir tableau 21-1). Celui-ci renvoie une reference qui sera ensuite exploi- 
ted dans les differents gestionnaires et methodes de traitement du script. Cet objet est automatique- 
ment detruit a la fin du script. II est egalement possible de le supprimer a Faide de la fonction 
xml_parser_f ree( ) (voir tableau 21-2). 

La fonction xml_parser_set_option( ) permet de configurer certaines options de traitement de 
Fanalyseur (voir tableau 21-2). Vous pourrez ainsi forcer la reconnaissance de la casse ou changer le 
codage initialise par defaut (UTF-8, US-ASCII, ISO-8859-1). 

Lors de F analyse du document XML, des gestionnaires d'evenements sont sollicites en fonction du 
type d'elements manipules. Le gestionnaire xml_set_element_handler() est appele lorsque Fanalyseur 
manipule une balise d'ouverture ou de fermeture alors que le gestionnaire xml_set_chara- 
cter_data_handl er( ) est appele a chaque manipulation du contenu d'une balise. 

Ces differents gestionnaires doivent etre declares avant le demarrage de F analyse afin de definir les 
traitements executes pour chacun de ces evenements. Les noms des fonctions de traitement utilisees 
ainsi que la reference de Fanalyseur doivent etre specifies dans les arguments de chaque gestionnaire 
d'evenements XML (voir tableau 21-3). 

Les fonctions auxquelles font reference les gestionnaires doivent etre prealablement declarees. Si les 
noms des fonctions de traitement peuvent etre choisis librement par le programmeur, il faut utiliser 
les arguments preconises par PHP (voir tableau 21-4). 

Lorsque toutes ces declarations sont effectuees, il est possible d' analyser le document XML. 
L'analyse XML est declenchee par l'appel de la fonction xml_parse( ). Cette fonction doit comporter 
en argument la reference de Fobjet anaiyseur concerne ainsi que le document a analyser (voir 
tableau 21-2). 



Gestionnaires et methodes de i'extension xmi 

Les tableaux suivants presentent la syntaxe de la fonction de creation de Fanalyseur et celle des prin- 
cipaux gestionnaires et methodes de I'extension (faisant reference a Fanalyseur prealablement cree). 
La liste des methodes n'est pas exhaustive mais celles que nous presentons ici vous permettront de 
realiser des analyseurs de base. Nous vous invitons a consulter la documentation officielle de PHP 
www.php.net (ou la documentation de www.nexen.net en francais) si vous desirez connaitre toutes les 
methodes disponibles avec I'extension xml. 
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Tableau 21-1. Syntaxe de la fonction de creation d'un analyseur 

xml_parser_create( ) 

Cette fonction permet de creer un objet analyseur XML et retourne une reference a cet analyseur pour qu'il puisse etre utilise 
ulterieurement par d'autres fonctions XML. La fonction retourne falseen cas d'erreur. 

Creation d'un analyseur a I'aide de la fonction xml_parser( ) : 
$analyseur = xml_parser_create( [codage] ) 

codage : parametre optionnel definissant le type de codage des caracteres de I'analyseur (UTF-8, US-ASCII, ISO-8859-1 ). 

En cas d'absence de ce parametre, le codage par defaut est ISO-8859-1 . 

$analyseur : variable dans laquelle sera memorisee la reference de I'analyseur cree. 

codage : (argument optionnel) codage des caracteres utilises : UTF-8, US-ASCII, ISO-8859-1 . 

[xxx] : le code xxx est facultatif. (Attention ! Vous ne devez surtout pas saisir les crochets [ et ] dans le code.) 

Tableau 21-2. Principales fonctions de I'extension xml 

xml_parser_set_option($analyseur, option, valeur) 

Permet de modifier les options de I'analyseur. La fonction retourne fal se si Sanalyseur n'est pas une reference valide sur un 
analyseur XML ou si I'option n'a pas pu etre modifiee. Si I'option est modifiee, la fonction retourne true, 
option et valeur : 

XML_OPTION_CASE_FOLDING : controle la gestion de la casse des balises de I'analyseur. Peut prendre la valeur 1 ou 0. Si 
I'option est a 1 (valeur par defaut), les noms des balises seront automatiquement transposes en majuscule avant d'etre traites. 
Sinon les noms des balises conservent la casse utilisee dans le document XML (option conseillee en general). 
XML_0PTI0N_TARGET_ENC0DING : modifie le codage utilise par I'analyseur. Lesvaleurs peuvent etre UTF-8, US-ASCII, ISO- 
8859-1 . Par defaut, le codage correspond a celui qui est defini par la fonction xml_parser_create( ). 
xml_parse($analyseur, $document) 

Cette fonction declenche Panalyse du document XML ($document). Le premier parametre est la variable contenant la reference 
de I'objet analyseur XML prealablement cree. Le second parametre correspond au document XML (ou a une partie du document) a 
analyser. Lors de I'analyse, differents gestionnaires d'evenements pourront etre sollicites en fonction du type de I'element mani- 
pule (voir le tableau 21 -3 pour connaitre ces gestionnaires). 
xml_parser_f ree ($analyseur) 

Cette fonction supprime I'objet analyseur XML prealablement cree afin de liberer les ressources utilisees par I'analyseur. 
Le parametre Sanalyseur indique la variable contenant la reference de I'objet analyseur XML a supprimer. 
Remarque : dans toutes les fonctions ci-dessus, $analyseur est la variable contenant la reference de I'analyseur prealablement 
cree avec la fonction xml_parser_create( ) (revoir si necessaire le tableau 21-1). 

Tableau 21-3. Gestionnaires d'evenements XML 

xml_set_element_handler($analyseur, 'traitementDebut' , 'traitementFin' ) 

Ce gestionnaire est sollicite chaque fois que I'analyseur XML rencontre une balise de debut ou de fin. Deux fonctions de traite- 
ment sont disponibles en fonction du type d'element manipule. Le parametre traitementDebut indique le nom de la fonction de 
traitement d'un element de debut alors que le parametre traitementFin indique le nom de la fonction de traitement d'un element 
de fin (les caracteristiques de ces fonctions sont detaillees dans le tableau 21-4). 
xm1_set_character_data_handl er($analyseur , ' trait ementContenu ' ) 

Ce gestionnaire est sollicite chaque fois que I'analyseur XML manipule le contenu d'un element (balise). Le parametre traite- 
mentContenu indique le nom de la fonction de traitement qui sera appelee dans ce cas (les caracteristiques de cette fonction 
sont detaillees dans le tableau 21-4). 

Remarque : dans toutes les fonctions ci-dessus, $analyseur est la variable contenant la reference de I'analyseur prealablement 
cree avec la fonction xml_parser_create( ) (revoir si necessaire le tableau 21-1). 
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Tableau 21-4. Parametrage des fonctions de traitement XML 

Descriptif des parametres devant etre employes dans les fonctions de traitement 

traitementDebut($analyseur, $element, $attribut) 

La fonction de traitement traitementDebutt ) est appelee chaque fois qu'une balise de debut est manipulee. Elle doit corn- 
porter trois parametres. Le premier ($analyseur) correspond a la reference de I'objet analyseur concerne. Le second ($ele- 
ment) contient le nom de la balise qui a provoque I'appel du gestionnaire. Le troisieme (Sattribut) contient un tableau 
associatif avec les attributs de la balise (si toutefois I'element comporte des attributs). Les cles de ce tableau seront les noms 
des attributs et ses valeurs seront les valeurs correspondantes. 
traitement Fin($analyseur, $el ement) 

La fonction de traitement traitementFint ) est appelee chaque fois qu'une balise de fin est manipulee. Elle doit comporter 
deux parametres. Le premier ($analyseur) correspond a la reference de I'objet analyseur concerne. Le second ($el ement) 
contient le nom de la balise qui a provoque I'appel du gestionnaire. 
traitementContenu($analyseur , $contenu) 

La fonction de traitement trai tementContenut ) est appelee chaque fois qu'une balise de fin est manipulee. Elle doit compor- 
ter deux parametres. Le premier (Sanalyseur) correspond a la reference de I'objet analyseur concerne. Le second ($contenu) 
contient les caracteres contenus par I'element sous la forme d'une chaine. 

Remarque : dans toutes les fonctions ci-dessus, $analyseur est la variable contenant la reference de I'analyseur prealablement 
cree avec la fonction xml_parser_create( ) (revoir si necessaire le tableau 21-1). 

Dans la suite de cette partie, deux exemples d' application de la technique de lecture et d' analyse d'un 
fichier XML a Faide de cette extension PHP vous permettront de mettre en pratique ces nouvelles 
fonctions. La premiere application permet de convertir un fichier XML en HTML, alors que la 
seconde permet d'extraire des donnees specifiques d'un fichier XML pour les memoriser dans un 
tableau de variables. 

Nous presenterons ensuite une technique d'ecriture d'un fichier XML a l'aide de scripts PHP. Elle 
permet de construire dynamiquement un fichier XML pour l'ecrire ensuite dans un fichier externe. 

Trois exemples vous seront ensuite proposes. Le premier permet d'ecrire directement un fichier XML 
sans traitement prealable. Le second offre la possibility de construire un document XML a partir de 
donnees stockees dans un tableau de variables pour l'ecrire ensuite dans un fichier externe. Le troi- 
sieme enfin permet de construire un document XML et de l'ecrire dans un fichier externe, mais, cette 
fois, avec des donnees issues d'un formulaire integre. 

Pour creer une interface de mise a jour complete d'un fichier XML, une etude de cas figure au 
chapitre 22 dans la section consacree a l'interface PHP-XML. 

Conversion d'un fichier XML au format HTML 

Cette application utilise l'extension xml de PHP pour convertir un fichier XML au format HTML. 
Les informations du fichier XML source seront analysees puis integrees dans un tableau HTML, lui- 
meme integre dans une structure de page HTML cible. 

Fichier XML source 

Le fichier XML utilise pour le test de cette application est enregistre sous le nom nomPeres.xml dans 
le meme repertoire que le fichier PHP. Son contenu est le suivant : 

<?xml version="1.0" encoding="UTF-8"?> 
<ages> 
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<pere > 

<nom>Dupond</nom> 

<prenom>Jean</prenom> 

<age>45</age> 
</pere> 
<pere > 

<nom>Durand</nom> 

<prenom>Cl aude</prenom> 

<age>35</age> 
</pere> 
<pere > 

<nom>Duval </nom> 

<prenom>Thierry</prenom> 

<age>32</age> 
</pere> 
</ages> 

Fichier de conversion PHP 

Le script de ce fichier est compose de deux parties principales. La premiere concerne l'analyseur 
XML et regroupe toutes les declarations de fonction et les instructions de creation et de configuration 
de l'objet analyseur. La seconde appelle successivement l'analyseur a chaque ligne du document et 
integre le resultat dans un tableau HTML construit dynamiquement. 

Etapes de creation du script PHP : 

1. Dans Dreamweaver, ouvrez un nouveau document HTML (menu Fichier>Nouveau>Page de 
base>HTML). Enregistrez-le sous le nom lectureXmll.php dans le repertoire /6-xml/chap21/inter- 
facePhpXml/ (sous-repertoire de /wamp/www/SITEflash/). 

2. La structure de la page HTML etant deja presente dans le code, placez-vous apres la balise <body> 
et saisissez les declarations des trois fonctions de traitement ci-dessous (voir figure 21-3). La 
fonction debut_element( ) permet de creer une nouvelle ligne ou une nouvelle cellule de tableau 
HTML des qu'une balise d'ouveiture est detectee (le type de balise peut etre different selon le 
nom de la balise analysee : pere, nom, prenom ou age). La seconde fonction permet de fermer la 
ligne ou la cellule des qu'une balise de fermeture est detectee. Enfin, la troisieme permet d'affi- 
cher le contenu de la balise dans la cellule correspondante du tableau HTML des qu'un contenu 
est detecte : 

ODOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional //EN" 

"http://www.w3.org/TR/html4/loose.dtd"> 

<html> 

<head> 

<title>Exemple de conversion XML vers HTML</title> 

<meta http-equiv="Content-Type" content="text/html ; charset=i so-8859-l"> 
</head> 
<body> 
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<?php 

################Declaration des fonctions de gestion Xml_parser 

function debut_element($analyseur, Selement, Sattribut) 

// Creation d'une nouvelle ligne pour chaque element PERE 

//et d'une nouvelle cellule pour les autres elements : NOM, PRENOM, AGE 

{ 

switch($element) 
{ 

case "pere": 

echo "<tr>"; 

break; 
case "nom": 

echo "<td>"; 

break; 
case "prenom": 

echo "<td>"; 

break; 
case "age": 

echo "<td>"; 

} 

} 

// 

function fin_element($analyseur, $element) 

// Termine la ligne de chaque element PERE 

//et la cellule des autres elements : NOM, PRENOM, AGE 

{ 

switch($element) 
{ 

case "pere": 

echo "</tr>"; 

break; 
case "nom": 

echo "</td>"; 

break; 
case "prenom": 

echo "</td>"; 

break; 
case "age": 

echo "</td>"; 

} 

} 

// 

function contenu_element($analyseur, $data) 
// Affiche simplement la valeur de 1 'element 
{ 

echo $data; 
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function contenu_element((analyseut, (data) 

// Aftiche simplement la valeur de 1 'element 



echo (data; 
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! - xMtMMMMMMOMMMMMIIMMCont lg du parser Xml 

(analyseut « xml_patset_cteate() ; creation du pat set 
xml_parser_set_option((analyseur, XJ!L_OPTIOM_CASE_rOLDIKG, false); 

x»l_set_element_handleE ((analyseut, ' debut_element' , ' f ln_element' ) ; 
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Figure 21-3 

Creation dufichier lectureXmll.php avec Dreamweaver 



3. A la suite de ces declarations, ajoutez le code ci-dessous (voir figure 21-3). La premiere ligne 
permet de creer un objet analyseur XML et memorise sa reference dans la variable $anal yseur. 
La seconde ligne configure F objet analyseur ann que la casse des elements soit prise en compte 
lors de 1' analyse. La troisieme et la quatrieme lignes definissent les gestionnaires d'evenements 
qui seront appeles lorsqu'un element sera analyse. Selon le type d' element (balise d'ouverture et 
de fermeture ou contenu de la balise), Fun des deux gestionnaires sera sollicite, ce qui declen- 
chera F execution de la fonction de traitement appropriee (debut_element( ), fin_element() ou 
contenu_el ement( )). 

mmmmmmmmmmmiHHHHHHHKoniiguraUon du parser xml 
$analyseur = xml_parser_create( ) ;//creation du parser 
xml_parser_set_option($analyseur, XML_OPTION_CASE_FOLDING, false) ; 
//permet de differencier les MAJUSCULES et les minuscules dans les noms de balise 
xml_set_element_handler($analyseur, 'debut_element' , 'fin„element' ) ; 
xml_set_characterjata_handler($analyseur, 'contenu_element' ) ; 
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4. Ajoutez enfin la derniere partie du script (voir le code ci-dessous). Elle permet de creer le tableau 
HTML et de l'integrer dans la page. Le fichier source XML est charge dans la variable $document. 
Une structure foreach( ) permet ensuite de declencher successivement l'analyse de chaque ligne 
du document et d'appeler les gestionnaires puis les fonctions de traitement appropries pour creer 
le tableau HTML tout en integrant les informations du fichier source XML dans chacune des 
cellules du tableau HTML. Apres analyse complete du document, la fonction xml_parser_f ree( ) 
est appelee afin de supprimer Fanalyseur XML initialement cree : 

mmmmmmmmmmmKOHsimcuoH du tableau html 

echo "<table border=\"l\" width=\"500\" eel 1 spacing=\"0\" eel 1 paddi ng=\ " 5\ " >"; 
echo "<tr bgcol or=\"#999999\"Xth>Nom</th><th>Prenom</th><th>Age</thX/tr>" ; 
// 

$document = file( 'nomPeres.xml ' ) ;//chargement du fichier XML 
// 

//Analyse chaque ligne du document XML 
foreach ($document as $line) { 
xml_parse($analyseur, $ 1 i n e ) ; 
} 

// 

xml_parser_f ree($analyseur) ; 

echo "</table>"; 
// 

?> 

5. Enregistrez le script PHP et testez son fonctionnement depuis le Web local. Lors de Fappel du 
fichier lectureXmll.php, un tableau HTML representant les donnees du fichier source XML 
s'affiche dans le navigateur (voir figure 21-4). 
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Figure 21-4 

Tableau HTML affiche lors de I'appel du fichier lectureXmll.php 
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Code complet du fichier lectureXmll.php : 

<!D0CTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional //EN" 

"http://www.w3.org/TR/html4/loose.dtd"> 

<html> 

<head> 

<title>Exemple de conversion XML vers HTML</title> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l"> 
</head> 
<body> 
<?php 

################Declaration des fonctions de gestion xml_parser 

function debut_element($analyseur, $element, Sattribut) 

// Creation d'une nouvelle ligne pour chaque element PERE 

//et d'une nouvelle cellule pour les autres elements : NOM, PRENOM, AGE 

{ 

switch($element) 

{ 

case "pere": 

echo "<tr>"; 

break; 
case "nom": 

echo "<td>"; 

break; 
case "prenom": 

echo "<td>"; 

break; 
case "age": 

echo "<td>"; 

} 

} 

// 

function fin_element($analyseur, Selement) 
// Termine la ligne de chaque element PERE 
//et la cellule des autres elements : NOM, PRENOM, AGE 

{ 

switch($element) 

{ 

case "pere": 

echo "</tr>"; 

break; 
case "nom": 

echo "</td>"; 

break; 
case "prenom": 

echo "</td>"; 

break; 
case "age": 

echo "</td>"; 

} 



PHP et XML 

Chapitre 21 



II 

function contenu_element($analyseur, $data) 
// Affiche simplement la valeur de 1 'element 
{ 

echo $data; 

} 

mmmmmmmmmmmmmmon^gurat^ on du parser xmi 

$analyseur = xml_parser_create( ) ;//creation du parser 

xml_parser_set_option($analyseur, XML_0PTI0N_CASE_F0LDI NG , false); 

//permet de differencier les MAJUSCULES et les minuscules dans les noms de balise 

xml_set_element_handler($analyseur, 'debut_element' , 'fin_element' ) ; 

xml_set_character_data_handler($analyseur, 'contenu_element' ) ; 

§WttfflHHHHHHHHHHHHHHHHHHHHHHHHHHHK OBSTRUCTION DU TABLEAU HTML 

echo "<table border=\"l\" width=\"500\" cellspacing=\"0\" cellpadding=\"5\" >"; 

echo "<tr bgcol or=\"#999999\"Xth>Nom</th><th>Prenom</th><th>Age</thX/tr>" ; 
// 

Sdocument = f i 1 e( 'nomPeres.xml ' ) ;//chargement du fichier Xml 
// 

//Analyse chaque ligne du document XML 
foreach ($document as $line) { 
xml_parse($analyseur, $line); 
} 

// 

xml_parser_free($analyseur) ; 

echo "</table>"; 
// 

?> 

</body> 
</html> 



Selection de donnees issues d'un fichier XML et memorisation 
dans un tableau de variables 

Cette seconde application montre comment utiliser l'extension xml de PHP pour selectionner des 
donnees dans un fichier XML puis les memoriser dans un tableau de variables dans Fattente d'un 
traitement ulterieur. Les donnees a recuperer seront selectionnees et classees selon la valeur de Fattribut 
nom de la balise pere. 

Fichier XML source 

Saisissez le document XML ci-dessous dans un fichier nomEnf ants .xml . Ann d'eviter les dysfonction- 
nements lies a la presence d' elements vides dans la structure XML analysee, veillez a ne pas ajouter 
d'espaces entre les balises pere et enfant : 

<?xml version="1.0" encoding="UTF-8"?> 
<ages> 

<pere nom="Dupond"Xenfant >PauK/enfantXenfant >Alain</enfantX/pere> 
<pere nom="Durand"Xenfant >Fabrice</enfantXenfant >Nicolas</enfantX/pere> 
</ages> 
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Fichier de selection PHP 

Le script de ce fichier de conversion PHP est compose de quatre parties principales. La premiere 
concerne la creation des deux tableaux destines a recuperer les resultats. La deuxieme regroupe 
toutes les declarations de fonction et les instructions de creation et de configuration de Fobjet analy- 
seur. La troisieme appelle successivement Fanalyseur a chaque ligne du document et integre le resultat 
dans les deux tableaux de variables crees initialement. Enfin, la derniere permet d'afficher a l'ecran 
le contenu des deux tableaux ann de s' assurer du bon fonctionnement du programme. 
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Figure 21-5 

Creation du fichier lectureXml2.php avec Dreamweaver 



Etapes de creation du script PHP : 

1 . Dans Dreamweaver, ouvrez un nouveau document PHP (menu F1 chi er>Nouveau>Page dynami que>PHP). 
Enregistrez-le sous le nom lectureXml2.php dans le repertoire /6-xml /chap21/interfacePhpXml / 
(sous-repertoire de /wamp/www/SITEflash/). 

2. Creez les deux structures de tableau dans lesquelles les resultats seront recuperes (SenfantsDu- 
pond et SenfantsDurand). Ajoutez ensuite une instruction d'initialisation de la variable 



PHP et XML 

Chapitre 21 



$glob_attribut qui memorisera le nom de l'attribut en cours de traitement. Ann que cette varia- 
ble puisse etre exploitee dans les differentes fonctions, declarez-la comme variable globale dans 
chacune des fonctions (voir figure 21-5) : 

<?php 

//creation des tableaux de resultats 

$enf antsDupond = arrayO; 

$enf antsDurand = arrayO; 

//init de la variable globale $glob_attribut 

$glob_attribut = ' ' ; 

3. A la suite de ces instructions, saisissez les declarations des trois fonctions de traitement ci- 
dessous. La fonction debut_el ement( ) permet de memoriser la valeur de l'attribut dans la variable 
$gl ob_attri but si le nom de la balise est egal a pere. Cette fonction est appelee des qu'une balise 
d'ouverture est detectee. La seconde fonction permet de supprimer le contenu de la variable 
$glob„attribut precedemment memorise des qu'une balise de fermeture pere est detectee afin 
d' initialiser cette variable pour le traitement de la balise suivante. Enfin, la troisieme fonction 
permet de memoriser la valeur de 1' element traite dans le tableau correspondant a sa famille 
(Dupond ou Durand). La selection du tableau est realisee avant l'affectation grace a un test de la 
valeur $glob_attribut precedemment memorisee. Cette derniere fonction est appelee des qu'un 
contenu est detecte : 

################Declaration des fonctions de gestion xml_parser 
function debut_element($analyseur, Selement, $attribut) { 
// analyse de la balise ouvrante 
global $glob„attribut; 
if ($element == 'pere' ) 

$glob_attribut = $attribut[ ' nom' ] ;//val eur de l'attribut "nom" 

} 

// 

function fin_element($analyseur, $element) { 

// Analyse de la balise fermante 

global $glob_attribut; 

if ($element == 'pere' ) 

$glob_attribut = ' ' ; 

} 

// 

function contenu_element($analyseur, $data) { 

// Analyse du contenu selon les valeurs d'attribut 

global $glob_attribut; 

if ($glob_attribut == 'Dupond') { 

global $enf antsDupond ; 

$enf antsDupond[] = $data; 

} 

if ($glob_attribut == 'Durand') { 

global $enf antsDurand ; 

$enf antsDurand[] = Sdata; 

} 

} 
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4. Ajoutez ensuite le code ci-dessous. La premiere ligne permet de creer un objet analyseur XML et 
memorise sa reference dans la variable $analyseur. La deuxieme ligne configure une premiere 
option afin que la casse des elements soit prise en compte lors de 1' analyse. La troisieme ligne 
configure une seconde option afin que le codage utilise dans le document XML soit UTF-8. Les 
deux dernieres lignes de code definissent les gestionnaires d'evenements qui seront appeles 
lorsqu'un element sera analyse. Selon le type d' element (balise d'ouverture et de fermeture ou 
contenu de la balise), Fun des deux gestionnaires sera sollicite et declenchera 1' execution de la 
fonction de traitement appropriee (debut_element( ), fin_element( ) ou contenu_el ement( )) : 

###############Creation et configuration du parser xml 

$analyseur = xml_parser_create( ) ;//creation du parser 

xml jarser_set_option($analyseur, XML_OPTION_CASE_FOLDING, false) ; 

//permet de differencier les MAJUSCULES et les minuscules dans les noms de balise 

xml_parser_set_option(Sanalyseur, XML_OPTION_TARGET_ENCODING, "UTF-8" ) ; 

//permet d'indiquer le type de codage du fichier XML 

xml_set_element_handler($analyseur, ' debut_el ement ' , 'fin_element' ) ; 

xml_set_character_data_handler($analyseur, 'contenu_element' ) ; 

5. Le code suivant permet de charger le document XML dans la variable Sdocument puis d'appeler 
Fanalyseur xml jarser( ) pour chacune des lignes. Une fois le traitement termine, l'analyseur est 
supprime a Faide de la fonction xml_parser_f ree( ) : 

$document = fi 1 e( 'nomEnf ants .xml ') ;//chargement du fichier XML 
//Analyse chaque ligne du document XML 
foreach (Sdocument as $line) { 
xml_parse($analyseur, $line); 

} 

//detruit l'analyseur XML 
xml_parser_f ree( Sanalyseur) ; 

6. Les elements desires etant desormais memorises dans les deux tableaux de variables $enfants- 
Dupond et $enf antsDurand, il est facile de les afficher a Fecran afin de s'assurer que le traitement a 
bien ete effectue : 

#############Utilisation des resultats du parser 
//affiche les resultats 

echo "Voici la liste des enfants de DUP0ND<br>"; 
foreach ( SenfantsDupond as Sprenom) { 
echo "- ". Sprenom. "<br>" ; 

} 

// 

echo "Voici la liste des enfants de DURAND<br>"; 
foreach ( SenfantsDurand as Sprenom) { 
echo "- ". Sprenom. "<br>" ; 

} 

?> 
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7. Enregistrez le script PHP et testez son fonctionnement depuis le Web local. Des l'appel du fichier 
lectureXml2.php, le fichier nomEnf ants .xml est charge, analyse, puis les elements selectionnes 
sont memorise et affiches dans le navigateur (voir la figure 21-6). 
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Figure 21-6 

Test du fichier lectureXml2.php dans le Web local 

Code complet du fichier 1 ectureXml 2 . php : 
<?php 

//creation des tableaux de resultats 
SenfantsDupond = arrayO; 
$enf antsDurand = arrayO; 

//initialisation de la variable globale $glob_attribut 
$glob_attribut = " ; 

############Declaration des fonctions de gestion Xml_parser 
function debut_element($analyseur, $element, $attribut) { 
// Analyse de la balise ouvrante 
global $glob_attribut; 
if (Selement == 'pere' ) 

$glob_attribut = $attribut['nom'];//valeur de l'attribut "nom" 

} 

// 

function fin_element($analyseur, Selement) { 

// Analyse de la balise fermante 

global $glob_attribut; 

if (Selement == 'pere' ) 

$glob_attribut = ' ' ; 

} 

// 

function contenu_element($analyseur, $data) { 

// Analyse du contenu selon les valeurs d'attribut 

global $glob_attribut; 

if ($glob_attribut == 'Dupond') { 
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global SenfantsDupond ; 
$enfantsDupond[] = $data; 
} 

if ($glob_attribut == 'Durand') { 

global $enfantsDurand ; 

$enfantsDurand[] = $data; 

} 

} 

###############Configuration et appel du parser xml 

$analyseur = xml_parser_create( ) ;//creation du parser 

xml_parser_set_option($analyseur, XML_OPTION_CASE_FOLDING, false) ; 

//Permet de differencier les MAJUSCULES et les minuscules dans les noms de balise 

xml_parser_set_option($analyseur, XML_OPTI0N_TARGET_ENCODING , "UTF-8" ) ; 

//Permet d'indiquer le type de codage du fichier XML 

xml_set_element_handler($analyseur, 'debut_element' , 'fin_element' ) ; 

xml_set_character_data_handl er($analyseur, ' contenu_el ement ' ) ; 
// 

$document = file( 'nomEnfants.xml' ) ; //chargement du fichier Xml 

//Analyse chaque ligne du document XML 

foreach (Sdocument as $line) { 

xml_parse($analyseur, Sline); 

} 

//detruit l'analyseur XML 
xml_parser_f ree($analyseur) ; 
#############Utilisation des resultats du parser 
//Affiche les resultats 

echo "Voici la liste des enfants de DUP0ND<br>"; 
foreach (SenfantsDupond as $prenom) { 
echo "- " . Sprenom. "<br>" ; 
} 

// 

echo "Voici la liste des enfants de DURAND<br>"; 
foreach ($enfantsDurand as $prenom) ( 
echo "- " . $prenom. "<br>" ; 
} 

?> 

Ecriture d'un fichier XML en PHP 
Fichier XML cible 

Les differents scripts presentes ci-dessous enregistrent de trois manieres differentes le meme fichier 
XML cible. 

A noter 

Ce fichier est identique au fichier utilise comme fichier XML source dans le deuxieme exemple de lecture : nomEn- 
f ants .xml . Cela vous permettra ensuite de coupler un script d'ecriture et de lecture de meme structure afin de 
creer facilement un programme de mise a jour de fichiers XML (voir I'application presentee dans la section Inter- 
face PHP-XML du chapitre 22). 
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<?xml version="1.0" encoding="UTF-8" ?> 
<ages> 

<pere nom="Dupond"Xenfant>Paul </enfant><enfant>Al ain</enfant></pere> 
<pere nom="Durand"Xenfant>Fabri ce</enf antXenf ant>Nicol as</enfantX/pere> 
</ages> 

Ecriture directe d'un fichier XML 

Dans ce premier script, le fichier est directement enregistre sans aucun traitement. Cette technique est 
souvent utilisee pour enregistrer un document XML transmis par une application Flash utilisant des 
methodes sendO ou sendAndl_oad( ) de la classe XML. Dans notre exemple, nous simulerons le 
document XML envoye par l'application Flash en le creant dans la variable $f i chi er^xml au debut du 
fichier. 

Ce script PHP tres simple est constitue de deux parties. La premiere permet de creer un document 
XML en interne pour simuler la reception d' informations issues d'une application Flash. La seconde 
assure 1' ecriture directe (sans aucun traitement) du document dans un fichier XML. 

Etapes de creation du script PHP : 

1. Dans Dreamweaver, ouvrez un nouveau document PHP (menu Fichier>Nouveau>Page dynami - 
que>PHP). Enregistrez-le sous le nomecritureXmll.php dans le repertoire /6-xml /chap21/interface- 
PhpXml / (sous-repertoire de /wamp/www/SITEflash/). 

2. La premiere partie du script permet de creer un document XML en interne afin de simuler la recupe- 
ration de ce dernier depuis une application Flash (voir figure 21-7) : 

// Declaration du fichier XML a enregistrer 

$fichier_xml = '<?xml version="1.0" encoding="UTF-8" ?> 
<ages> 

<pere nom="Dupond"Xenfant>Paul </enfant><enfant>Al ain</enf antX/pere> 
<pere nom="Durand"Xenfant>Fabri ce</enf antXenfant>Nicol as</enfantX/pere> 
</ages> ' ; 

3. La seconde partie du code permet d'ouvrir le fichier cible nomEnf ants .xml en mode ecriture puis 
d'ecrire le contenu du document precedemment cree dans ce fichier. Apres l'ecriture, le fichier 
est ferme a 1' aide de la fonction fclose( ). La derniere instruction permet d'afficher un simple lien 
hypertexte pointant sur le fichier nomEnf ants .xml afin de pouvoir controler la bonne ecriture du 
fichier XML : 

// Ecriture du fichier XML 

$fp = fopen( "nomEnfantsl .xml " , "w"); 
//ouverture du fichier nomEnf ants .xml 
fwrite($fp, $fichier_xml ) ; 
//ecriture du fichier 
fclosedfp) ; 
//fermeture du fichier 

echo "<a href=\"nomEnfantsl .xml \" target=\"_bl ank\" > Voir le fichier XML </a>"; 
?> 
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Figure 21-7 

Creation dufichier ecritureXmll.php avec Dreamweaver 



4. Enregistrez le script PHP et testez son fonctionnement depuis le Web local. Des l'appel du fichier 
ecritureXml l.php, le document XML $fichier_xml est enregistre dans le fichier nomEnfants.xml . 
Cliquez sur le lien hypertexte pour afficher le fichier nomEnfants .xml dans une seconde fenetre de 
navigateur (voir la figure 21-8). 

Code complet du fichier ecri tureXml l.php : 
<?php 

II Declaration du fichier XML a enregistrer 

$fichier_xml = '<?xml version="1.0" encoding="UTF-8" ?> 
<ages> 

<pere nom="Dupond"Xenf ant>Paul</enfantXenfant>Al ain</enf antX/pere> 
<pere nom="Durand"Xenf ant>Fabrice</enfantXenfant>Nicol as</enfantX/pere> 
</ages>' ; 

II Ecriture du fichier XML 

$fp = fopen( "nomEnfantsl .xml " , "w"); 
//ouverture du fichier nomEnfants.xml 
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fwrite($fp, $fichier_xml ) ; 
//ecriture du fichier 
fclose($fp) ; 
//fermeture du fichier 

echo "<a href=\"nomEnf antsl .xml \" target=\"_bl ank\" > Voir le fichier XML </a>"; 
?> 
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Figure 21-8 

Test du fichier ecritureXmll.php dans le Web local 

Ecriture d'un fichier XML a partir d'un tableau de variables 

Dans ce second script, les donnees sont issues de deux tableaux de variables (SenfantsDupond et 
SenfantsDurand). Cette technique peut etre utilisee apres traitement d' informations cote serveur et 
memorisation des resultats dans des tableaux de variables. Dans notre exemple, nous ne presenterons 
pas le script de traitement des informations et partirons directement des deux tableaux de variables 
semblables a ceux crees par le script 1 ectureXml 2 . php presente plus haut. 

Le script de ce fichier d' ecriture PHP est compose de trois parties principales. La premiere concerne 
la creation des deux tableaux destines a simuler les resultats issus d'un traitement prealable. La 
deuxieme assure la construction d'un document XML et 1' integration des resultats. La troisieme 
permet d'ecrire le document precedemment cree dans un fichier XML. 

Etapes de creation du script PHP : 

1. Dans Dreamweaver, ouvrez un nouveau document PHP (menu Fichier>Nouveau>Page dynami- 
que>PHP). Enregistrez-le sous le nom ecritureXml2.php dans le repertoire /6-xml/chap21/inter- 
facePhpXml / (sous-repertoire de /wamp/www/SITEf 1 ash/). 
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Creation dufichier ecritureXml2.php avec Dreamweaver 



2. La premiere partie du script permet de creer les deux tableaux de variables (SenfantsDupond et 
SenfantsDurand) en interne. Le contenu ainsi cree est ensuite affiche a l'aide de fonctions 
print_r( ) en guise de test (voir figure 21-9) : 

<?php 

//Creation des tableaux de donnees 
$enf antsDupond = array( "Paul " , "Al ain" ) ; 
$enf antsDurand = array( "Fabrice" , "Nicol as" ) ; 
//Test : affichage des tableaux crees 
echo '<pre>';//A utiliser pour tests 
print_r($enfantsDupond) ; 
print_r($enfantsDurand) ; 
echo '</pre>' ; 

3. La partie suivante permet d'ouvrir le fichier cible nomEnf ants .xml en mode ecriture puis de construire 
le contenu du document XML dans la variable $fichier_xml. La creation iterative des differents 
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elements enfant des families Dupond et Durand est realisee a Faide de deux boucles foreachO 
(instmction de boucle dediee a la gestion des tableaux de variables ; revoir si necessaire le chapitre 9) : 

// 

$fp= fopen( "nomEnfantsl .xml " , "w" ) ; //ouverture du fichier XML 
// CONSTRUCTION DU FICHIER XML 

$fichier_xml ="<?xml version=\"1.0\" encoding=\"UTF-8\" ?>\r\n"; 

$fichier_xml .="<ages>\r\n" ; 

$fichier_xml .="\t<pere nom=\"Dupond\">" ; 

// AJOUT DES ELEMENTS ENFANTS DE DUPOND 

foreach (SenfantsDupond as Sprenom) { 
$fichier_xml .="<enfant>" . Sprenom . "</enfant>"; 
} 

// 

$fichier_xml .="</pere>\r\n" ; 
$fichier_xml .="\t<pere nom=\"Durand\">" ; 

// AJOUT DES ELEMENTS ENFANTS DE DURAND 

foreach (SenfantsDurand as $prenom) { 
$fichier_xml .="<enfant>" . Sprenom . "</enfant>"; 
} 

// 

$fichier_xml .="</pere>\r\n" ; 
$fichier_xml .="</ages>"; 

4. Une fois le document XML elabore et memorise dans la variable $fichier_xml, enregistrez-le 
dans le fichier nomEnf ants .xml de la meme maniere que dans l'exemple precedent puis fermez-le 
a Faide de la fonction fclose( ) : 

fwrite($fp, $fichier_xml ) ;//ecriture du fichier 
fclose($fp) ;//fermeture du fichier 

echo "<a href=\"nomEnfantsl.xml \" target=\"_bl ank\" > Voir le fichier XML </a>"; 
?> 

5. Enregistrez le script PHP et testez son fonctionnement depuis le Web local. Des Fappel du fichier 
ecritureXml2.php, le contenu des deux tableaux est affiche dans le navigateur. Le document 
XML $fichier_xml est ensuite cree puis enregistre dans le fichier nomEnf ants .xml. Cliquez sur le 
lien hypertexte pour afficher le fichier nomEnf ants, xml dans une seconde fenetre de navigateur 
(voir la figure 21-10). 

Code complet du fichier ecri tureXml 2 . php : 
<?php 

//Creation des tableaux de donnees 
$enfantsDupond = arrayt "Paul " , "Al ain") ; 
SenfantsDurand = arrayt "Fabrice" , "Nicol as" ) ; 
//Test : affichage des tableaux crees 
echo '<pre>';//A utiliser pour tests 
print_r($enfantsDupond) ; 
print_r($enfantsDurand) ; 
echo '</pre>' ; 

// 

$fp= fopen( "nomEnfantsl .xml " , "w" ) ;//Ouverture du fichier XML 
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II- 
$fichie 
Sfichie 
Sfichie 

// 

foreach 

$fichier 

} 

// 

$fichier 
$fichier 

// 

foreach 
$f ichier 
} 

// 

$fichier 
Sfichier 

// 

fwrite( 
f cl ose( 
echo "< 
?> 



CONSTRUCTION DU FICHIER XML 

r_xml ="<?xml version=\"1.0\" encoding=\"UTF-8\" ?>\r\n"; 

r_xml .="<ages>\r\n" ; 

r_xml .="\t<pere nom=\"Dupond\">" ; 

AJOUT DES ELEMENTS ENFANTS DE DUPOND 

(SenfantsDupond as $prenom) { 

_xml . = "<enfant>" . Sprenom . "</enf ant>" ; 



_xml .="</pere>\r\n" ; 

_xml . = "\t<pere nom=\"DLirand\">" ; 

AJOUT DES ELEMENTS ENFANTS DE DURAND 

(SenfantsDurand as $prenom) { 

_xml .="<enfant>" . Sprenom . "</enfant>"; 



xml 

xml 



"</pere>\r\n" 
"</ages>" ; 



$fp, $fichier_xml );//ecriture du fichier 
$fp) ;//fermeture du fichier 

a href=\"nomEnfantsl .xml \" target=\"_bl ank\" > Voir 



e fichier XML </a>" 
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<?xml version="1.0" encoding="UTF-8" ?> 






- <ages> 

- <pere nom="Dupond"> 

<enfant>Paul</enfant> 
<enfant> Alain </enfant> 
</pera> 

- <pere nom="Durand'> 

<enfant>Fabrlc8</enfant> 
<enfant>Nicolas</enfant> 
</pere> 
</ages> 
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Test du fichier ecritureXml2.php dans le Web local 
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Ecriture d'un fichier XML a partir d'un formulaire 

Dans ce troisieme script, les donnees sont issues d'un formulaire HTML. Cette technique peut etre 
utilisee pour generer une interface de creation de fichier XML a partir d'un formulaire en ligne. 

Le script de ce fichier d'ecriture PHP est compose de quatre parties principales. La premiere 
concerne la creation du formulaire destine a saisir les donnees a integrer dans le document XML. La 
deuxieme est consacree a 1' initialisation des variables HTTP envoyees par le formulaire en methode 
POST. La troisieme assure la construction d'un document XML et F integration des donnees issues 
du formulaire. La quatrieme permet d'ecrire le document precedemment cree dans un fichier XML. 

Etapes de creation du script PHP : 

1. Dans Dreamweaver, ouvrez un nouveau document HTML (menu Fichier>Nouveau>Page de 
base>HTML). Enregistrez-le sous le nom ecritureXml3.php dans le repertoire /6-xral /chap21/ 
interfacePhpXml / (sous-repertoire de /wamp/www/SITEf 1 ash/). 
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Figure 21-11 

Creation du formulaire integre dans le fichier ecritureXml3.php avec Dreamweaver 



2. Passez en mode creation et creez une zone de formulaire (utilisez le bouton Formulaire de la 
barre d'outils Inserer). A l'interieur du formulaire, creez un tableau afin d'assurer la mise en page 
des elements du formulaire. Commentez chaque cellule avec un texte approprie (voir figure 21-11). 
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Ajoutez ensuite quatre champs de texte. Dans le panneau Proprietes, nommez successivement 
leur nom d' occurrence enfantll, enfantl2, enfant21 et enfant22 (voir figure 21-1 1). 

3. Dans la derniere ligne du tableau, ajoutez un champ masque. Nommez son occurrence action et 
initialisez sa valeur avec ecriture. A cote de ce champ, ajoutez un bouton de soumission. Selec- 
tionnez le formulaire (en cliquant sur la balise <f orm> dans le selecteur de balise, par exemple) 
puis configurez le panneau Proprietes en saisissant ecritureXml3.php dans le champ action et la 
methode POST dans le menu deroulant situe en dessous. Ajoutez un simple lien hypertexte libelle 
« Voir le fichier avant » pointant vers le fichier nomEnfants .xml . 
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Figure 21-12 

Creation du fichier ecritureXmB.php avec Dreamweaver 



4. Une fois le formulaire cree, passez en mode code et saisissez les lignes de code ci-dessous 
apres la balise <body>. La deuxieme ligne permet d'initialiser la variable action (champ 
masque) envoyee par le formulaire. La seconde teste cette variable afin d'executer le script 
d'ecriture si sa valeur est egale a ecriture. Le debut du script commence par quatre instructions 
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d'initialisation des champs texte du formulaire (enfantll, enfantl2, enfant21, enfant22), 
(voir figure 21-12) : 

<?php 

if (i sset($_P0ST[ ' action ']) ) $action=$_POST[ ' action '] ; else $action="inconnue" ; 
if($action=="ecriture") { 

mmmmmmmmmmmmmmmmmmtECRnmE 

//Initialisation des variables envoyees par le formulaire 

if(isset($_POST['enfantll'])) $enfantll=$_POST['enfantll']; else $enfantll="Enfant inconnu"; 
if(isset($_P0ST['enfantl2'])) $enfantl2=$_P0ST[ 'enfantl2' ] ; else $enfantl2="Enfant inconnu"; 
if(isset($_P0ST['enfant21'])) $enfant21=$_P0ST['enfant21']; else $enfant21="Enfant inconnu"; 
if(isset($_P0ST['enfant22'])) $enfant22=$_P0ST[ 'enfant22' ] ; else $enfant22="Enfant inconnu"; 

5. La partie suivante ouvre le fichier nomEnfants.xml en mode ecriture et assure la construction du 
document XML $f i chi er_xml a partir des valeurs saisies dans les champs texte du formulaire : 

// 

$fp= fopen( "nomEnfants .xml " , "w" ) ; //Ouverture du fichier XML 
// CONSTRUCTION DU FICHIER XML 

$fichier_xml ="<?xml version=\"1.0\" encoding=\"UTF-8\" ?> 
\r\n"; 

$fichier_xml .="<ages>\r\n" ; 

$fichier_xml .="\t<pere nom=\"Dupond\">" ; 

// AJOUT DES ELEMENTS ENFANTS DE DUPOND 

$fichier_xml .="<enfant>" . Senfantll . "</enfant>"; 

$fichier_xml .="<enfant>" . $enfantl2 . "</enfant>"; 

// 

$fichier_xml .="</pere>\r\n" ; 
$fichier_xml .="\t<pere nom=\"Durand\">" ; 

// AJOUT DES ELEMENTS ENFANTS DE DURAND 

$fichier_xml .="<enfant>" . $enfant21 . "</enfant>"; 

$fichier_xml .="<enfant>" . $enfant22 . "</enfant>"; 

// 

$fichier_xml . ="</pere>\r\n" ; 
$fichier_xml .="</ages>"; 

6. Une fois le document XML elabore dans la variable $f i chi er_xml , il suffit de l'enregistrer dans le 
fichier nomEnfants.xml ouvert precedemment. Le fichier est ensuite ferme a l'aide de la fonction 
fcloseO. La derniere instmction, (headerO), redirige l'utilisateur vers Faffichage du fichier 
nomEnfants.xml qui vient d'etre cree : 

// 

fwritedfp, $fichier_xml ) ;//ecriture du fichier 
fcl ose( $fp) ; //fermeture du fichier 
header ( "Location: nomEnfants .xml " ) ; 

mmmmmmmmmmmmmmmmmriH o- ecriture 

}//f in du IF 
?> 
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7. Enregistrez le script PHP et testez son fonctionnement depuis le Web local. Des l'appel du fichier 
ecri tureXml 3 . php, le formulaire s'affiche dans le navigateur. Saisissez les prenoms de votre choix 
dans les quatre champs texte et cliquez sur le bouton Valider. Le document XML $fichier_xml 
est cree a partir des valeurs saisies puis enregistre dans le fichier nomEnfants.xml. Le fichier 
nomEnfants.xml s'affiche ensuite automatiquement dans la fenetre du navigateur (voir la 
figure 21-13). 
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<?xml version="1.0" encoding="UTF- 
8" ?> 
■ <ages> 

- <pere norn="Dupond"> 

<enfant>Paul</enfant> 
<enfant>Alain</enfant> 
</pere> 

- <pere nom="Durand "> 

<enfant>Fabrice</enfant> 
<enfant>Nicolas</enfant> 
</pere> 
</ages> 



AVANT 



A 
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ECRITURE D'UN FICHIER XML 
Noms des enfants DUPOND : 

ler Enfant : |Pjeire 
2eme Enfant : Laurent 



APRES 



Noms des enfants DURAND ; 

1 er Enfant : 
2eme Enfant 
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<?xml version="1.0" encoding="UTF- 

8" ?> 

<ages> 

- <pere nom="Dupond'> 

<enfant>Piarre</enfant> 
<enfant>Laurent</enfant> 
</pere> 

- <pere nom="Durand "> 

<Bnfant>Thomas</enfant> 
<enfant>David<:/enfant> 
</per©> 
</ages> 



i 

Figure 21-13 

Test du fichier ecritureXmB.php dans le Web local 
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Module simpleXML de PHP 5 

Le module SimpleXML est une nouvelle extension disponible depuis PHP 5. Si vous desirez mani- 
puler des documents XML avec PHP 4, vous devrez utiliser Fanalyseur syntaxique XML presente 
precedemment ou des technologies plus avancees comme SAX, DOM, XSLT... Notez que l'exten- 
sion SimpleXML est installee par defaut sur toutes les distributions PHP 5, ce qui vous garantit une 
portabilite de vos scripts d'un serveur a l'autre. 

Contrairement a l'extension XML, beaucoup plus lourde a mettre en place en raison de la configura- 
tion de ses differents gestionnaires, SimpleXML se caracterise par sa simplicite d'utilisation. Toute- 
fois, notons que si SimpleXML est tres bien adapte pour analyser ou modifier des fichiers XML 
simples, son utilisation n'est pas recommandee pour gerer des fichiers XML complexes (il est prefe- 
rable dans ce cas d'utiliser les technologies SAX, DOM ou XSLT). 
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Tableau 21-4. Syntaxe des principales fonctions et methodes SimpleXML 



$Simpl eXMLEl ement=simpl exml_l oad_f i 1 e(nomFi chier ) 

Fonction qui per met d'importer un document XML place dans un fi chier externe (nomFi ch i er) en le transformant en element 
SimpleXML. Si I'importation echoue la fonction retourne f al se. 

$Simpl eXMLEl ement=simpl exml_l oad_stri ng(nomChaine) 

Fonction qui permet de lire un document XML memorise dans une variable (nomChaine) en le transformant en element 
SimpleXML. Si la lecture echoue la fonction retourne fal se. 

$Simpl eXMLEl ement->asXML( nomFi chier) 

Cette methode renvoie le contenu XML d'une partie (ou la totalite si vous I'appliquez sur I'element racine) du document 
SimpleXML sous forme d'une chaine de caracteres qui peut etre simplement affichee (s'il n'y a pas d'argument) ou enregistree 
dans un fichier externe (dans ce cas le nom du fichier est celui de I'argument de la methode : nomFi chier). 

$SimpleXMLElement->children( ) 

Cette methode permet de recuperer tous les enfants d'un element SimpleXML. La liste retournee par la methode sera structuree 
comme un tableau de variables et pourra done etre facilement exploitee a I'aide de la fonction f oreach( ) (voir les exemples 
ci-dessous pour plus de details). 
$Simpl eXMLEl ement->attributes( ) 

Cette methode permet de recuperer tous les attributs d'un element SimpleXML. La liste retournee par la methode sera structuree 
comme un tableau de variables et pourra done etre facilement exploitee a I'aide de la fonction f oreach( ) (voir les exemples 
ci-dessous pour plus de detail). 
$Simpl eXMLEl ement->xpath(expressionXpath) 

Cette methode permet de recuperer une selection de nceuds d'un element SimpleXML selon une expression Xpath (non abor- 
dee dans cet ouvrage). La liste retournee par la methode sera structuree comme un tableau de variables et pourra done etre 
facilement exploitee a I'aide de la fonction foreach( ). 



Chargement d'un document XML 

L'importation d'un document XML, puis sa transformation en element SimpleXML, peut etre reali- 
sed a partir d'un fichier externe contenant le document XML ou a partir d'une variable interne dans 
laquelle le document XML a ete memorise. 

Importation d'un fichier externe 

Pour importer un document XML contenu dans un fichier externe, il suffit d'utiliser la fonction 
simplexml_load_file(nomFichier).L argument de cette fonction doit correspondre au chemin du 
fichier a importer. Si l'importation est reussie, la fonction renverra un objet SimpleXML qui pourra 
etre ensuite etre manipule par les autres fonctions de la classe SimpleXML, en cas d'erreur la fonction 
renverra la valeur fal se. 

Exemple de lecture du fichier nomPeres .xml utilise au debut de ce meme chapitre : 
<?php 

$xml = simplexml_load_file( 'nomPeres. xml ' ); 
echo $xml ->pere[0]->nom; // Affiche "Dupond" 
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Lecture d'une variable interne 

Pour lire un document XML contenu dans une variable interne, il suffit d'utiliser la fonction 
simplexml JoacLstring(nomChaine). L'argument de cette fonction doit correspondre au nom de la 
variable. Si la lecture reussie, la fonction renverra un objet SimpleXML qui pourra etre ensuite manipule 
par les autres fonctions de la classe SimpleXML. En cas d'erreur la fonction renverra la valeur f al se. 

Exemple de lecture de la variable SnomPeres contenant le meme document XML que dans l'exemple 
precedent : 

<?php 

$nomPeres='<ages> 
<pere > 

<nom>Dupond</nom> 

<prenom>Jean</prenom> 

<age>45</age> 
</pere> 
<pere > 

<nom>Durand</nom> 

<prenom>Cl aude</prenom> 

<age>35</age> 
</pere> 
<pere > 

<nom>Duval </nom> 

<prenom>Thi erry</prenom> 

<age>32</age> 
</pere> 
</ages>' ; 

$xml = simplexml_load_string($noiriPeres) ; 
echo $xml ->pere[0]->nom; // Affiche "Dupond" 

?> 

Exportation d'un document XML 

Vous pouvez facilement afficher ou enregistrer le contenu de tout ou partie d'un element SimpleXML 
en utilisant la methode asXML( ). 

Affichage d'un element SimpleXML 

Pour afficher tout ou partie d'un element SimpleXML a l'ecran, vous pouvez utiliser la methode 
asXMLO sans indiquer d'argument. Dans ce cas, la methode renvoie la partie du document XML 
selectionne dans la chaine de caracteres. 

Exemple d'affichage de F element $xml : 
<?php 

$xml = simpl exml_l oad_f ile( ' nomPeres.xml ' ) ; 

echo $xml ->asXml ( ) ; 

//affichera la chaine de caractere : 

//Dupond Jean 45 Durand Claude 35 Duval Thierry 32 

?> 
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Enregistrement d'un element SimpleXML 

Pour enregistrer tout ou partie d'un element SimpleXML dans un fichier externe, vous pouvez utiliser 
la methode asXML(nomFichier) en indiquant le nom du fichier XML a generer dans l'argument de la 
methode. 

Exemple d' enregistrement de F element $xml dans un fichier nomme exportPeres.xml (dans cet 
exemple, le fichier exporte est identique au fichier importe nomPeres.xml mais nous verrons par la 
suite qu'il est possible de modifier le contenu du document XML avant son enregistrement) : 

<?php 

$xml = simplexml_load_file( 'nomPeres.xml ' ); 
$xml ->asXml ( ' exportPeres .xml ' ) ; 
//Enregistrera le meme document nomPeres.xml 
//dans un fichier nomine exportPeres.xml 
?> 



Gestion des nceuds d'un element SimpleXML 

Pour exploiter le contenu d'un element SimpleXML, vous devrez mettre en place des scripts de 
lecture du (ou des) nceud(s) desire(s) : 

Lecture d'un simple nceud 

Pour lire un seul nceud d'un element SimpleXML, il vous suffit simplement d'utiliser successivement 
la syntaxe propre a la gestion des objets en specifiant le nceud desire (exemple : $pere=$xml ->pere; 
puis $nom=$pere->nom;). 

Exemple de lecture du nceud <nom> de l'element $xml : 

<?php 
$xml str=' 
<ages> 

<pere > 

<nom>Dupond</nom> 
<prenom>Jean</prenom> 
<age>45</age> 
</pere> 
</ages>' ; 

$xml = simplexml_load_string($xmlstr) ; 

// 

$pere=$xml ->pere; 
$nom=$pere->nom; 

// 

echo $nom; 

//Affichera le nom "Dupond" 

?> 
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Lecture de plusieurs nceuds 

Pour lire plusieurs nceuds d'un element SimpleXML, vous devez preciser l'indice des nceuds ou 
utiliser la fonction foreachO. En effet, si l'element SimpleXML comporte plusieurs nceuds de 
meme nom, ils sont renvoyes dans un tableau indexe. Pour acceder a ces differents nceuds vous 
pouvez bien sur les lire isolement en utilisant leur indice (exemple : $pere=$xml ->pere[l]) mais il est 
souvent plus pratique d'utiliser directement la fonction foreachO pour les exploiter tous au sein 
d'une boucle. 

Exemple de lecture des nceuds <nom> de l'element $xml : 

<?php 
$xmlstr=' 
<ages> 
<pere> 

<nom>Dupond</nom> 
<prenom>Jean</prenom> 
<age>45</age> 
</pere> 
<pere > 

<nom>Durand</nom> 
<prenom>Cl aude</prenom> 
<age>35</age> 
</pere> 
<pere> 

<nom>Duval </nom> 
<prenom>Thierry</prenom> 
<age>32</age> 
</pere> 
</ages>' ; 

$xml = simplexml_load_string($xmlstr); 

// A vec i 'index 

echo 'Avec IVindice du tableau : $xml ->pere[l]<br>' ; 

$pere=$xml ->pere[l] ; 

$nom=$pere->nom; 

// 

echo $nom. "<br>" ; 

//affichera le nom "Durand" 

// ^vec foreachO 

echo 'Avec la fonction : foreach($xml ->pere as $pere)<br>'; 

foreach($xml ->pere as $pere) 

{ 

$nom=$pere->nom; 
echo $nom. "<br>" ; 
} 

//Affichera les noms des differents peres 
?> 
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<?xml version="1.0* encoding="UTF- 
8" ?> 
- <ages> 

- <pere nom="Oupond"> 

<enfant>Paul</enfant> 
<enfant>Alain</enfant> 
</pere> 

- <pere nom='Durand"> 

<enfant>Fabrice</enfant> 
<enfant>Nicolas</enfant> 
</pere> 
</ages> 



AVANT 



A 
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ECRITURE D'UN FICHIER XML 
Noms des enfants DUPOND : 

ler Enfant : [Plena 
2eme Enfant : Laurent 
Noms des enfants DURAND : 

ler Enfant 
2eme Enfant 



APRES 
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<?xml version="1.0" encodmg="UTF- 
8" ?> 
■ <ages> 

- <pere nom="Dupond*> 

<enfant>Pierre</enfant> 
<enfant>Laurent</enfant> 
</pere> 

- <pere nom=Durand"> 

<enfant>Thomas</enfant> 
<enfant>David</enfant> 
</pere> 
</ages> 



I 

Figure 21-13 

Affichage des differents nauds <nom> a i 
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'aide de leur indice ou avec la fonction foreach( ) 



Lecture des nceuds enfants 

Pour lire les nceuds enfants d'un element SimpleXML, vous pouvez utiliser la methode children( ). 
Cette methode retournera les nceuds enfants dans un tableau qui pourra facilement etre manipule a 
l'aide de la fonction foreach( ) comme dans les exemples precedents. 

Exemple de lecture des nceuds enfants de l'element <pere> : 

<?php 
$xmlstr=' 
<ages> 
<pere> 

<nom>Dupond</nom> 

<prenom>Jean</prenom> 

<age>45</age> 
</pere> 
<pere > 

<nom>Durand</nom> 

<prenom>Cl aude</prenom> 

<age>35</age> 
</pere> 
<pere> 

<nom>Duval </nom> 

<prenont>Thierry</prenom> 

<age>32</age> 
</pere> 



XML avec Flash et PHP 

Partie VI 



</ages>' ; 

$xml = simplexml_load_string($xmlstr); 

// A vec un s i m pi e indice de tableau 

echo 'Toutes les infos des elements enfants du premier pere : <br>'; 
$pere=$xml ->pere[0] ; 
$infos=$pere->chi 1 dren( ) ; 

echo " <br>"; 

echo "Norn =".$infos[0]."<br>"; 
echo "Prenom =" .$infos[l] . "<br>" ; 
echo "Age =".$infos[2]."<br>"; 

// A vec foreachO 

echo " <br>"; 

echo 'Toutes les infos de tous les peres (avec foreachO ): <br>'; 

foreach($xml ->pere as $pere) 

{ 

$infos=$pere->chil dren( ) ; 

echo " <br>"; 

echo "Norn =".$infos[0]."<br>"; 
echo "Prenom =" .$infos[l] . "<br>" ; 
echo "Age =" .$infos[2] . "<br>" ; 
} 

?> 




Figure 21-14 

Affichage des differents nasuds enfants de <pere> a Vaide de leur indice ou avec la function foreachO 
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Gestion des attributs d'un element SimpleXML 

Selon la structure du document XML, les informations peuvent aussi etre issues de la valeur d'un 
attribut d'un nceud. Pour exploiter le contenu des attributs d'un element SimpleXML, vous devrez 
mettre en place des scripts de lecture du (ou des) attribut(s) desire(s). 

Lecture de I'attribut d'un nceud 

Pour lire I'attribut d'un nceud d'un element SimpleXML, il suffit d'utiliser la meme syntaxe que celle 
des tableaux de variables (exemple : $pere[ 'tel ' ]). 

Exemple de lecture de I'attribut tel du nceud <pere> : 

<?php 

$xmlstr=' 

<ages> 

<pere tel ="0145455643" > 

<nom>Dupond</nom> 

<prenom>Jean</prenom> 

<age>45</age> 
</pere> 
</ages> ' ; 

$xml = simplexml_load_string($xmlstr) ; 

// 

$pere=$xml ->pere; 
$tel =$pere[ ' tel ' ] ; 

// 

echo $tel ; 

//Affichera le telephone "0145455643" 
?> 

Lecture de tous les attributs d'un nceud 

Les attributs d'un nceud etant structures comme un tableau de variable, pour lire tous les attributs d'un 
meme nceud, vous pourrez utiliser la fonction foreach( ) comme indique dans l'exemple ci-dessous. 

Exemple de lecture de tous les attributs du nceud <pere> : 

<?php 
$xml str=' 
<ages> 

<pere tel ="0145455643" fax="01458877" mai 1 ="jmdef rance@eyrol 1 es .com" > 

<nom>Dupond</nom> 
<prenom>Jean</prenom> 
<age>45</age> 
</pere> 
</ages> ' ; 

$xml = simplexn)l_load_string($xmlstr) ; 

// 

foreach($xml ->pere->attributes( ) as $nom=>$val eur) 
{ 

echo $nom."=".$valeur."<br>"; 

} 

//affichera les lignes ci-dessous : 
//tel =0145455643 
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//fax=01458877 

//mail=jmdefrance@eyrol les.com 
?> 




Figure 21-15 

Affichage des differents attributs du nasud <pere> a I'aide de la fonctionforeachQ 



Modification de I'attributs d'un nceud 

Les attributs peuvent etre modifies, ajoutes et meme supprimes (en utilisant la fonction unsetO). 
II suffit pour cela de changer leur valeur comme Fillustre Fexemple ci-apres. 

Exemple de modification, d'ajout et de suppression des attributs du noeud <pere> : 

<?php 

$xmlstr=' 

<ages> 

<pere tel ="0145455643" fax="01458877" mai 1 ="jmdef rance@eyrol 1 es . com" > 

<nom>Dupond</nom> 
<prenom>Jean</prenom> 
<age>45</age> 
</pere> 
</ages>' ; 

$xml = simplexml_load_string($xmlstr); 

// AFFICHAGE APRES 

echo "Liste des attributs de <pere> AVANT : <br>"; 

echo " <br>"; 

foreach($xml ->pere->attributes( ) as $nom=>$valeur) 
{ 

echo $nom. "=" . $val eur. "<br>" ; 
} 
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echo " <br>"; 

// 

$pere=$xml ->pere; 

// MODIFICATION d'un attribut 

$pere['teT ]="036688332Z"; 

// AJOUT d'un attribut 

$pere['portable'] = , '0676097656" ; 

// SUPPRESSION d'un attribut 

unset($pere['fax']); 

// AFFICHAGE APRES 

echo "Liste des attributs de <pere> APRES : <br>"; 

echo " <br>"; 

foreach($xml ->pere->attributes( ) as $nom=>$val eur) 
{ 

echo $nom. " = " .$valeur. "<br>" ; 
} 

echo " <br>"; 

//Affichera les lignes ci-dessous : 



//tel =0366883322 

//mai 1 =jmdef rance@ey rol 1 es . com 

//portable=0676097656 

?> 



Codes sources disponibles en ligne 

Tous les codes sources des applications presentees dans cet ouvrage sont disponibles sur Internet : www.editions- 
eyrolles.com (mots-cles : Flash PHP), 




Figure 21-16 

Affichage des modifications effectuees sur les attributs du naeud <pere> 
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Interfagage Flash-PHP-XML 
et autres interfacages XML 



Dans les chapitres 20 et 21, nous avons presente differentes techniques de traitement de donnees 
XML a partir d'une application Flash ou PHP. Nous allons maintenant appliquer ces techniques 
d'interfacage grace a l'etude de plusieurs cas pratiques. 

Vous decouvrirez une application PHP permettant la mise a jour d'un fichier XML (interface 
PHP 4-XML), une application Flash integrant un menu deroulant dont les options sont definies par 
un fichier XML externe (interface Flash-XML) et enfin une application Flash-PHP permettant de 
visionner et d'annoter des images dont 1'URL et le commentaire sont stockes dans un fichier XML 
externe (interface Flash-PHP-XML). 

Pour completer ce tour d' horizon des applications Flash ou PHP utilisant le format XML, deux 
sections sont dediees aux interfacages Flash-XML-PHP-MySQL et Flash-XML-serveur socket PHP. 
Une application de signets dynamiques illustre les interfaces Flash-XML-PHP-MySQL et une appli- 
cation de dialogue en ligne (chat) illustre les interfaces Flash-XML-serveur socket PHP. 

Interface PHP-XML 

Voici une application PHP qui permet de mettre a jour un fichier XML. 



A noter 

Les scripts de lecture et I'analyse des donnees du fichier XML utilisent les fonctions de I'extension XML de PHP 
presentees dans le chapitre 21 . 
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Formulaire PHP de mise a jour d'un fichier XML 

Cette application permet de mettre a jour des informations stockees dans un fichier XML. Elle est 
composee du fichier XML dans lequel seront stockes les informations et d'un fichier PHP qui assure 
Factualisation des donnees du fichier XML. Le fichier PHP contient un formulaire dans lequel seront 
affiches les informations issues du fichier XML avant modification et un programme PHP qui lit les 
donnees du fichier XML et les ecrit dans ce meme fichier lors de la validation du formulaire. Le script 
PHP est constitue de deux programmes deja etudies dans le chapitre 21 : un premier script assure la 
lecture en direct du fichier XML (revoir ecritureXml3.php dans le chapitre 21) et le second ecrit les 
donnees modifiees par le formulaire dans le fichier XML (revoir lectureXml2.php dans le 
chapitre 21). 
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de mise a jour ) 



Script PHP 
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Ecriture 



.xml 



Figure 22-1 

Principe de Vinterface PHP-XML utilisee pour I 'application du formulaire de mise a jour d'un fichier XML 



Le fichier XML 

Le fichier XML est identique au fichier nomEnfants. xml utilise dans les scripts de lecture XML 
presentes dans le chapitre 21. II est structure autour d'un element racine <noms> dans lequel on 
retrouve plusieurs elements <pere> comprenant a leur tour des elements <enfant> et leur valeur 
(valeurs correspondant aux noms des enfants). 



A noter 

Les elements <pere> sont personnalises a I'aide d'un attribut nom indiquant le nom de la famille concernee. 



Fichier nomEnfants. xml : 

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> 
<noms> 
<pere nom="Dupond"> 

<enfant>Pierre</enfant> 

<enfant>Laurent</enf ant> 

</pere> 
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<pere nom="Durand"> 

<enfant>Maxime</enfant> 
<enfant>David</enf ant> 

</pere> 
</noms> 
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Figure 22-2 

Creation dufichier XML nomEnfants.xml avec Dreamweaver 



1. Creez un nouveau document XML avec Dreamweaver et sauvegardez-le sous le nom nomEn- 
fants.xml dans un sous-repertoire du dossier www/SITEf 1 ash/ de votre serveur local. Nous avons 
enregistre le fichier XML dans le repertoire SITEflash/6-xml/chap22/miseAjourXml/ mais vous 
pouvez utiliser tout autre repertoire de votre choix dans la mesure oil il se trouve dans le dossier 
www/SITEflash/. 

2. Verifiez que l'en-tete XML cree automatiquement est conforme a celui du code ci-dessous et 
modifiez-le si necessaire (voir figure 22-2) : 



| <?xml version="1.0" encoding="UTF-8" standal one="yes"?> 
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3. A la suite de l'en-tete, ajoutez une balise ouvrante <noms>. 

4. Sous ce premier element, creez deux series de balises <pere></pere>. Dans chaque balise pere, 
ajoutez un attribut nom suivi du nom de famille approprie. 

5. A Finterieur de chaque element pere, ajoutez deux elements <enfant></enfant> et renseignez 
leur valeur avec les noms des enfants concernes (n'ajoutez pas d'espace entre les elements ; voir 
le code de la figure 22-2). 

6. Cloturez le fichier en ajoutant une balise fermante </noms> puis enregistrez-le. 
Le fichier PHP 

Le fichier PHP est constitue de code et d'un formulaire qui s'affiche a l'ecran lors de l'appel du 
fichier. La premiere partie du code lit les donnees issues du fichier XML afin d' initialiser les valeurs 
par defaut de chaque champ du formulaire. La seconde partie met en forme un document XML en y 
incluant les donnees modifiees (les donnees sont envoyees lors de la validation du formulaire integre 
dans le fichier) et gere l'ecriture de ce document dans le fichier XML. 
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function contenu_eleaent((analyseur, (data) { 

// analyse du contenu selon les valeucs d'attribut 
global (glob_attribut; 
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Figure 22-3 

Creation du formulaire integre dans le fichier modificationXmll ,php avec Dreamweaver 
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Etapes de creation du script PHP : 

1. Pour vous eviter de creer de nouveau le formulaire de mise a jour, vous utiliserez le fichier 
ecritureXml3.php (revoir chapitre 21) apres Favoir enregistre sous le nom modificationXml l.php 
dans le repertoire /6-xml /chap22/interfacePhpXml / (sous-repertoire de /wamp/www/SITEf 1 ash/). 

2. Copiez le script ci-dessous a partir du fichier 1 ectureXml 2 . php (voir chapitre 21). Ce script sera 
integre apres le bloc de script d'ecriture du fichier modi f i cati onXml l.php (voir figure 22-3) : 

mmmmmmmmmmmmiHHHHHHHHHHHHHHHHHHH^ciuRE 

II Initialisation de la variable globale $glob_attribut 
$gl ob_attri but = ' ' ; 

################Declaration des fonctions de gestion xml_parser 
function debut_element($analyseur, Selement, Sattribut) { 
// Analyse de la balise ouvrante 
global $glob_attribut; 
if ($element == 'pere' ) 

$gl ob_attri but = $attribut[ ' nom' ] ; // Valeur de 1 ' attri but nom 
} 

// 

function fin_element($analyseur, $element) { 

// Analyse de la balise fermante 

global $glob_attribut; 

if ($element == 'pere' ) 

$glob_attribut = ' ' ; 

} 

// 

function contenu_element($analyseur, $data) { 

// Analyse du contenu selon les valeurs d'attribut 

global $glob_attribut; 

if ($glob_attribut == 'Dupond') { 

global $enf antsDupond ; 

$enf antsDupond[] = $data; 

} 

if ($glob_attribut == 'Durand') { 
global $enf antsDurand ; 
$enf antsDurand[] = $data; 

} 

} 

###############Configuration et appel du parser xml 
$analyseur = xml_parser_create( ) ; // creation du parser 
xml_parser_set_option($analyseur, XML_OPTION_CASE_FOLDING, false) ; 
// Permet de differencier les MAJUSCULES et les minuscules dans les noms de balise 
xml_parser_set_option($analyseur, XML_OPTION_TARGET_ENCODING. "UTF-8" ) ; 
// Permet d'indiquer le type de codage du fichier XML 
xml_set_element_handler($analyseur, 'debut_element' , 'fin_element' ); 
xml_set_character_data_handl er($analyseur, ' contenu_el ement ' ) ; 
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II 

$document = f i 1 e( 'nomEnf ants .xml ' ) ;//chargement du fichier XML 

// Analyse chaque ligne du document XML 

foreach (Sdocument as $line) { 

xml_parse($analyseur, $line); 

} 

// Detruit 1'analyseur XML 
xml_parser_f ree( Sanalyseur) ; 

mmmmmmmmmmmmmmmiHHHHHHtnn de lecture 
?> 

3. Le formulaire utilise dans le script ecritureXml3.php etait uniquement destine a l'ajout de 
donnees ; les valeurs initiales des quatre champs n'etaient done pas configurees. Ajoutez quatre 
petits scripts dans le formulaire arm de combler ce manque et de le transformer en formulaire de 
mise a jour (les valeurs initiales utilisees sont celles des tableaux SenfantsDupond et Senfants- 
Durand). Les scripts a ajouter dans le formulaire sont signales par des caracteres gras dans le code 
ci-dessous : 

<table width="496" border="0" eel 1 spacing="0" cellpadding="5"> 
<tr> 

<td colspan="2"Xdiv al ign="center" cl ass="Styl el">MODIFICATION 
D'UN FICHIER XML </div></td> 

</tr> 
<tr> 

<td col span="2"Xdiv al ign="center"Xspan cl ass="Styl el">Noms des 
enfants DUPOND : </spanX/divX/td> 

</tr> 
<tr> 

<td width="248"Xdiv al ign=" right" cl ass="Styl e2">ler Enfant : 
</divX/td> 

<td width="248"Xinput name="enfantll" type="text" id="enfantll" 

*value="<?php echo $enfantsDupond[0] ; ?>"></td> 
</tr> 
<tr> 

<td><div align="right" cl ass = "Styl e2">2eme Enfant : </divX/td> 
<td><input name="enf antl2" type="text" id="enfantl2" 
*»value="<?php echo $enfantsDupond[l] ; ?>"></td> 

</tr> 

<tr> 

<td col span="2"Xdiv al i gn="center"Xspan cl ass="Styl el">Noms des 
enfants DURAND : </spanX/divX/td> 

</tr> 
<tr> 

<td width="248"Xdiv align="right" cl ass="Styl e2">ler Enfant : 
</divX/td> 
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<td><input name="enf ant21" type="text" id="enf ant21" 

*value="<?php echo $enfantsDurand[0] ; ?>"></td> 
</tr> 
<tr> 

<td><div al ign="n'ght" cl ass="Styl e2">2eme Enfant : </div></td> 
<td><input name="enf ant22" type="text" id="enfant22" 
*»value="<?php echo $enfantsDurand[l] ; ?>"></td> 

</tr> 

<tr> 

<td colspan="2"Xdiv al i gn="center"> 

<input type="submit" name="Submit" valuer" MODI FI ER"> 
<input name="action" type="hidden" id="action" value="ecriture"> 
</divX/td> 
</tr> 
</table> 

4. Une fois ces modifications effectuees, enregistrez le nouveau fichier et testez son fonctionnement 
depuis le Web local. Des l'appel du fichier modi f i cati onXml 1 . php, le formulaire s'affiche dans le 
navigateur avec ses champs initialises. Modifiez Fun des prenoms et cliquez sur le bouton Modi- 
fier. Apres validation du formulaire, le document XML $fichier_xml est modifie a partir des 
valeurs du formulaire puis enregistre dans le fichier nomEnfants.xml. Le fichier nomEnfants.xml 
modifie s'affiche dans la fenetre du navigateur (voir la figure 22-4). 
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Figure 22-4 

Test du fichier modificationXmll .php dans le Web local 
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Interface Flash-XML 

Avec les interfaces Hash-XML, les fichiers XML sont exploites pour le stockage de donnees structurees. 
Cette technique, souvent utilisee pour memoriser les informations de configuration d'une application 
Flash, est aussi une bonne alternative a l'usage d'une base de donnees (exploitee exclusivement en 
lecture) car elle est relativement simple a mettre en ceuvre et peut etre exploitee sur tout type de plate- 
forme en ligne ou en local. 



A noter 

Cette interface Flash-XML ne peut pas etre consideree comme un interfagage (tel que nous I'avons defini dans les 
terminologies des sources de donnees du chapitre 11) entre I'application Flash et XML car le systeme n'assure 
pas un transfert bidirectionnel mais un simple chargement du fichier XML (cette application ne pourra done pas 
ajouter ou modifier les donnees stockees dans le fichier XML). 
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Figure 22-5 

Principe de V interface Flash-XML utilisee pour I'application du menu deroulant XML 



Un menu deroulant XML 

Nous vous proposons de realiser un menu deroulant dont la configuration sera definie dans un fichier 
XML. Ce menu permet d'ouvrir differentes pages Web grace a un simple clic sur l'option desiree. 
Le nombre d' options proposees par le menu peut varier selon la structure du fichier XML charge. 



Le fichier XML 

Le fichier XML comprend un element racine <menu> dans lequel on retrouve les differentes options 
proposees dans le menu. Chaque element <option> comprend deux attributs, titre et lien, qui 
correspondent a l'etiquette affichee dans le menu et a l'URL ciblee si Ton clique dessus. 
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Fichier menu.xml : 

<?xml version="1.0" encoding="UTF-8" standal one="yes"?> 
<menu> 

<option titre="choix 1" lien="pagel.htm" /> 
<option titre="choix 2" lien="page2.htm" /> 
<option titre="choix 3" lien="page3.htm" /> 
<option titre="choix 4" lien="page4.htm" /> 

</menu> 

1. Creez un nouveau document XML avec Dreamweaver et sauvegardez-le sous le nom menu.xml 
dans un sous-repertoire du dossier www/SITEf 1 ash/ de votre serveur local. Nous avons selectionne 
le repertoire SITEf 1 ash/6-xml /chap22/menuXml / mais vous pouvez utiliser tout autre repertoire de 
votre choix. 

2. Verifiez que l'en-tete XML cree automatiquement est conforme a celui du code ci-dessous et 
modifiez-le si necessaire : 

| <?xml version="1.0" encoding="UTF-8" standal one="yes"?> 

3. A la suite de l'en-tete, ajoutez une balise ouvrante <menu>. 

4. Sous ce premier element, creez une balise <option> avec ses deux attributs choix et lien puis 
dupliquez deux fois cette ligne. Personnalisez chacun des attributs en vous assurant que les URL 
des pages Web sont bien accessibles depuis le repertoire du fichier XML. 

5. Cloturez le fichier en ajoutant une balise fermante </menu> puis enregistrez votre nouveau fichier 
(voir figure 22-6). 
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Figure 22-6 

Creation du fichier XML menu.xml avec Dreamweaver 
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Le document Flash 

Le document Flash doit afficher le menu et ses options selon la configuration du fichier menu . xml cree 
precedemment. 



A noter 

L'application realisee ci-dessous a pour seul but de tester le fonctionnement du menu, mais la procedure serait 
identique si vous deviez integrer le menu deroulant dans une application existante. 



1. Creez un nouveau document Flash et sauvegardez-le sous le nom menu.fl a dans un sous-reper- 
toire du dossier www/SITEf 1 ash/ de votre serveur local (utilisez le meme repertoire que celui dans 
lequel vous avez precedemment enregistre le fichier XML). 

2. Creez trois caiques : Label, Action et Menu. 

3. Dans le caique Label, creez une image cle dans l'image 10 puis une autre dans l'image 20. 
Nommez l'image cle 10 affichage (dans le champ Image du panneau des proprietes) et l'image 
cle 20 chargement. 

4. Placez-vous dans l'image cle 1 du caique Action et saisissez le code ci-dessous. Les deux premie- 
res lignes permettent de creer l'objet XML et de le configurer afin d'ignorer les eventuels espaces 
dans le fichier charge. La partie qui suit correspond a la declaration du gestionnaire onl_oad(). 
Ainsi, des que le fichier XML sera completement charge, la tete de lecture sera placee sur 
F etiquette affichage. La derniere ligne appelle la methode l_oad( ) afin de demarrer le chargement 
du fichier menu. xml dans l'objet monDoc_xml (voir figure 22-7). 
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1 stop [J; 

2 

3 // Creation de l'objet X!tL avec le CON3TRUCTZUR 

4 roonDoe_xml - new Xh*L(); 

5 monDoc_xuil . lgnoreUhlte ■ true; 

6 // GESTIONNAIRE onLoad 

7 monDoc_xiol.onLoad ■ function(auccea) ( 

8 if (auccea) ( 

9 gotoAndStop ("ari ichage") ; 

10 ) else ( 

11 trace ("Erreur de chargement XHL")i 

12 > 

13 >; 

13 // Appel de la HETHOPE loac 

16 monDoc_xnl. load("menu.xnl") ; 

l? //uu*»u»M**»»*u**unuuuuu*uuu*uuuuu*unu»» 

16 



Figure 22-7 

Configuration de V image cle 1 (etiquette chargement) du caique Action 
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//mmmmmmmmmmmmtt 

II Creation de l'objet XML avec le CONSTRUCTED 

monDoc_xml = new XMLO; 

monDoc_xml .ignoreWhite = true; 

// GESTIONNAI RE onLoad 

monDoc_xml .onLoad = function(succes) { 
if (succes) { 
gotoAndStop( "aff i chage" ) ; 

}; 

l/WHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHt 

II Appel de la METHODE loadO 

monDoc_xml . 1 oad( "menu.xml " ) ; 

//mmmmmmmmwHHHHHHHHHHHtt 

stop( ) ; 

5. Placez-vous ensuite sur l'image cle 10 et creez une image cle. Dans cette meme image, saisissez 
le code ci-dessous (voir figure 22-8). Cette partie coiTespond aux declarations des differentes 
fonctions utilisees dans l'application : initBtnDepl ier( ), i ni tBtnRepl ier( ) (ces deux fonctions 
sont appelees par les boutons deplierl_btn et replierl_btn places dans le clip de la tete du 
menu), afficheOptions(xPos, yPos), effaceOptions( ) (ces deux fonctions permettent d'afficher 
ou d'effacer les differentes options du menu) et appel URUurl ) (cette derniere fonction permet 
< 'ouvrir une fenetre de navigateur lors d'un clic sur l'une des options). 

//iHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHt 
function initBtnDepl ier( ) { 

// Gestionnaire du bouton deplierl_btn 
tetel_mc.deplierl_btn.onRelease = functionO { 

tetel_mc.gotoAndStop( "Depl ier" ) ; // Aller a l'image Deplier 
initBtnRepl ier( ) ; // Initialiser le gestionnaire du bouton replierl_btn 
afficheOptions(tetel_mc._x, tetel_mc._y) ; // afficher les options 
}; // Fin du gestionnaire 
} // Fin de la fonction 
//iHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHW 
function initBtnRepl ier( ) { 

// Gestionnaire du bouton replierl_btn 
tetel_mc.replierl_btn.onRelease = functionO { 

tetel_mc.gotoAndStop( "Repl ier" ) ; // Aller a l'image Replier 
initBtnDepl ier( ) ; // Initialiser le gestionnaire du bouton deplierl_btn 
effaceOptions( ) ; // Effacer toutes les options 
}; // Fin du gestionnaire 
} // Fin de la fonction 
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//mmmmmmmmmmmmw 

II Fonction de construction et de gestion du sous-menu 

function afficheOptions(xPos , yPos) { 

tableauOption_array = new ArrayO; // Creation du tableau des options 
for (i=0; i<monDoc_xml .firstChil d.childNodes. length; i++) { 

var nomOpti on: String = "option"+i+"_mc" ; // Norn du MC option a creer 
_root.attachMovie("option_mc" , nomOption, i); // Creation du MC option 
var cetteOption:MovieClip = _root[nomOption] ; // MC cree 
tableauOption_array.push(nomOption) ;//ajout de 1 'option dans le tableau 
cetteOption . tit rejxt. text = (monDoc_xml . f i rstChil d. chi ldNodes[i ] . 
**attributes.titre) ; 

// Initialisation du champ texte de 1 'option 

cetteOption .lien = (monDoc_xml . f i rstChi 1 d. chi 1 dNodes[i ] . attributes .1 ien) ; 
// Initialisation du lien URL de 1 'option 

cetteOption. _x = xPos; // Initialisation de la position X de 1 'option 
cetteOption._y = yPos += cetteOption. ^height; // Initialisation 
*»de la position Y de 1 'option 

cetteOption. _al pha = 60; // Regie 1 'alpha des options a 60 I par defaut 
// Gestionnaire d'evenements si 1'on survole cette option 
cetteOption. onRollOver = functionO { 

this.jlpha = 100; // Augmente 1 'alpha a 100 % 

}; 

// Gestionnaire d'evenements si 1'on sort de cette option 
cetteOption. onRollOut = functionO { 

thi s ._al pha = 60;//retablit l'alpha a 60 % 

}; 

// Gestionnaire d'evenements si 1'on clique sur cette option 
cetteOption. onRelease = functionO { 
appel URLCthi s . 1 ien) ; 

// Appelle la fonction d'ouverture d'une fenetre 

}; 

} // Fin du for 
} // Fin de la fonction 
1/mHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHt 
II Fonction de suppression du sous-menu 
function efface0ptions( ) { 

for O'=0; i<tableauOption_array. length; i++) { 

unl oadMovie(tabl eau0ption_array[i ] ) ; // Supprime les MC option du menu 
) // Fin du for 

delete tableau0ption_array; // Supprime le tableau de memorisation des options 
} // Fin de la fonction 



Interfagage Flash-PHP-XML et autres interfagages XML 

Chapitre 22 

i /mmmmmmmmmmmmift 

II Fonction d'ouverture d'un fenetre avec appel de l'URL de 1 'option selectionnee 
function appel URKurl ) { 

if (url != null ) { // si 1 'URL existe 

getURKurl, "_blank"); // Ouverture de la page dans un nouveau navigateur 

} else { 

traceC'il n'y a pas de lien pour cette option"); 
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stop O ; 

/ / nnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 

tetel_nte.scop() ; 
InitBtnDepliecO ; 

//nnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 

function lnltBtnDepller () { 

//Gestlonnaire du bouton depllerl_btn 
tetel_roc.deplierl_btn.onRelease - function() { 

tetel mc.gotoAndStop ("Depl ler ") ;//aller a I'll 
lnltBtnReplier () ;/ / initialiser le gest lonnaiiH 
aff icheOptions (tetel_mc._x, tetel_roc._y) ;//al 
);//fin du gestlonnaire 
)//fin de la fonction 

m //nnnnunnnnuMnnnnnnunnuunuunnnnnnnnnunnn 

IS function lnltBtnReplier () { 

//Gestlonnaire du bouton replierl_btn 
tetel_roc.replierl_btn.onRelease - funcclon() { 

tetel mc.gotoAndStop ("Replier") ;//aller a l'l 
mitBtnDeplier () ; // mit lal lser le gestionnaii 

20 eff aceOptlonsf) ;//ef facet toutes les options 

21 );//fin du gestlonnaire 

22 )//fin de la fonction 
23 

24 // Fonction de construction et de gestion du sous mer 

25 function af f icheOptions (xPos, yPos) < 

26 tableauOption_array ■ new Array () ;//creatlon du t 

27 for ri«0: KmonDoc xml . f irstChi Id. chi ldNodes. lenc % 
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Figure 22-8 

Configuration de Vintage cle 10 (etiquette affichage) du caique Action 



6. A la suite de ces declarations de fonction, saisissez le code ci-dessous. La premiere instruction 
permet d'arreter la tete de lecture du scenario principal sur cette image cle. La deuxieme 
instruction positionne la tete de lecture du clip tetel_mc (clip situe a la tete du menu deroulant 
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qui gere les deux boutons deplierl_btn et replierljrtn) sur la premiere image cle de son scenario. 
La troisieme instruction permet d'appeler la fonction d'initialisation du bouton deplierl_btn 
actuellement accessible par le clip tetel_mc afin qu'il soit operationnel si Ton clique dessus pour 
deplier le menu : 

/ / iHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHt 
stop( ) ; 

tetel_mc.stop( ) ; 
ini tBtnDepl ier( ) ; 

//mmmmmmmmmmmmt* 
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Configuration du scenario du clip tetel_mc (etiquette Replier) 
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7. Creation de la tete du menu : placez-vous ensuite sur 1' image cle 10 du caique Menu et inserez 
une image cle. Sur la scene de cette image, creez un nouveau clip a paitir d'un rectangle noir puis 
nommez son occurrence tetel_mc. Ouvrez ce clip et creez quatre caiques sur son scenario : 
Label, Texte, Icone et Bouton (voir figure 22-9). Dans l'image cle 1 du caique Label creez une 
image cle et nommez-la Replier. Creez une image cle dans l'image 10 de ce meme caique et 
nommez-la Depl ier (voir figure 22-10). 
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Figure 22-10 

Configuration du scenario du clip tetel_mc (etiquette Deplier) 



8. Personnalisez les deux caiques Texte et Icone afin de distinguer les deux phases Deplier et 
Repl ier. Dans l'image cle 1, convertissez le rectangle noir en bouton et nommez son occurrence 
depl ierl_btn. Realisez la meme operation dans l'image cle 10 mais nommez cette fois le bouton 
replierl_bm. 
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9. Creation du clip d'option : revenez sur le scenario principal et creez un nouveau clip (touches 
Ctrl + F8) que vous nommerez option_mc. Dans l'image cle 1 du scenario de ce nouveau clip, 
ajoutez une zone de texte dynamique dont l'occurrence sera nommee titre_txt. Ouvrez la 
bibliotheque (touche Fll). Dans la liste, cliquez avec le bouton droit sur le clip option_mc 
et selectionnez Liaison. Dans la boite de dialogue Proprietes de liaison, validez les cases 
a cocher Exporter pour ActionScript et Exportez pour la premiere fois (voir figure 22-11) 
arm de pouvoir par la suite creer des occurrences de ce clip a l'aide de la methode attach- 
Movie( ). 
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Figure 22-11 

Configuration du clip optionjnc 



10. Enregistrez votre document et publiez-le dans le meme repertoire. Testez ensuite 1' applica- 
tion avec le mode test de Flash (Ctrl + Entree) arm de vous assurer de son bon fonctionne- 
ment (voir figure 22-12). Si vous cliquez sur la tete du menu, il doit se deplier (ou se replier). 
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En position depliee, si vous cliquez sur l'une des options, une fenetre de navigateur doit s'ouvrir 
et afficher la page Web coiTespondante (voir figure 22-12). 
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Figure 22-12 

Test du menu XML 



Interface Flash-PHP-XML 

Contrairement aux interfaces Flash-XML (lecture seule du fichier XML), les interfaces Flash-PHP- 
XML permettent d'ajouter ou de modifier les donnees stockees dans le fichier XML mais necessitent 
l'usage de scripts serveur PHP et ne sont done plus independantes du type de la plate-forme. Cette 
technique est souvent utilisee comme alternative aux bases de donnees lorsque Ton desire consulter, 
ajouter ou actualiser des informations structurees dans un fichier XML. 
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Figure 22-13 

Principe de V interface Flash-PHP-XML utilisee pour V application de la visionneuse 



Une visionneuse de diapositives XML 

Nous vous proposons de realiser une visionneuse de diapositives. Dans le contexte de cette applica- 
tion, nous appellerons « diapositive » une image a laquelle on peut ajouter un commentaire. Cette 
application peut, par exemple, etre utilisee par le directeur artistique d'une agence de design qui 
souhaite annoter les differentes propositions de visuels d'un projet. 

L' application comporte deux objets XML. Le premier est nomme fichier_xml car il sera a la fois 
utilise comme objet de chargement lors de la lecture du fichier XML (utilisation de la methode 
LoadO) et comme objet d'envoi lors de la memorisation d'un commentaire (utilisation de la 
methode sendAndl_oad( )). Le second objet XML est nomme reponse_xml car il receptionnera un 
message du script PHP confirmant le bon enregistrement du fichier ou un message d'erreur dans le 
cas contraire. 

Le fichier XML 

Le fichier XML est structure a partir d'un element racine <visionneuse> dans lequel on retrouve 
autant d'elements <diapo> que de visuels a commenter. A l'interieur d'un element <diapo>, chaque 
information relative a la diapositive est integree dans des balises specifiques (<image> et <commen- 
tai re>). 

Fichier diapositive. xml : 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<visionneuse> 
<diapo> 

<image>photol. jpg</image> 

<commentai re>Ideal pour creer un site dynamique</commentaire> 
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</diapo> 
<diapo> 

<image>photo2. jpg</image> 

<commentai re>PHP-MySQL et Dreamweaver 8</commentai re> 
</diapo> 
<diapo> 

<image>photo3. jpg</image> 

<commentai re>FLASH 8 et les jeux en reseau</commentai re> 
</diapo> 
<diapo> 

<image>photo4. jpg</image> 

<commentai re>10 jeux avec FLASH 8</commentai re> 
</diapo> 
</visionneuse> 
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Figure 22-14 

Creation du fichier XML diapositive.xml avec Dreamweaver 
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1. Creez un nouveau document XML avec Dreamweaver et sauvegardez-le sous le nom diaposi - 
tive.xml dans un sous-repertoire du dossier www/SITEflash/ de votre serveur local. Nous avons 
enregistre le fichierXML dans le repertoire SITEflash/6-xml/chap22/visionneuseXml/ mais vous 
pouvez utiliser tout autre repertoire de votre choix dans la mesure ou il se trouve dans le dossier 
www/SITEflash/. 

2. Verifiez que l'en-tete XML cree automatiquement est conforme a celui du code ci-dessous et 
modifiez-le si necessaire : 

| <?xml version="1.0" encoding="UTF-8" standalone="yes"?> 

3. A la suite de l'en-tete, ajoutez une balise ouvrante <visionneuse>. 

4. A l'interieur de ce premier element, creez autant de balises <diapo></diapo> que de diapositives a 
visionner. 

5. A l'interieur de chaque element diapositive, ajoutez deux types de balises <image></images> et 
<commentai reX/commentai re> puis renseignez les valeurs de F element image en saisissant FURL 
du visuel a afficher (dans notre exemple, toutes les images se trouvent dans le meme repertoire 
que F application mais si ce n'est pas le cas, assurez-vous que les fichiers JPEG sont bien acces- 
sibles depuis ce repertoire). 

A noter 

Les photos doivent etre au format JPEG sans optimisation (format standard). Leur dimension doit etre en rapport 
avec I'espace d'affichage de I'application (prendre par exemple des photos d'une largeur de 200 pixels). 



6. Cloturez le fichier en ajoutant une balise fermante </vi si onneuse> puis enregistrez-le. 



Le fichier PHP 

Le fichier vi si onneuse . php a pour fonction de recuperer le document XML modifie, de l'enregistrer 
dans le fichier di apositive.xml puis de construire et de retourner une reponse XML qui confirme que 
F operation d'enregistrement s'est bien deroulee ou qui indique la nature du probleme si ce n'est pas le cas. 

1. Creez un nouveau document PHP dans Dreamweaver et sauvegardez-le sous le nom vision- 
neuse.php dans un sous-repertoire du dossier www/SITEflash/ de votre serveur local (utilisez le 
meme repertoire que celui dans lequel vous avez precedemment enregistre le fichier XML). 

2. Saisissez les instructions header ( ) suivantes afin que les informations retournees par le script ne 
soient pas memorisees dans le cache des navigateurs ou des proxies (voir figure 22-15) : 

<?php 

header ( "Content -Type: text/xml " ) ; 

// Blocage du cache 

headerC'Expires: Mon, 12 Jul 1995 02:00:00 GMT"); 

// Date d'expiration anterieure a la date actuelle 

headerCLast-Modified: " . gmdateC'D, d M Y H:i:s") . " GMT"); 

// Indique de toujours modifier la date 

header( "Cache-Control : no-cache, must-revalidate"); 

// no-cache pour HTTP/1.1 

headerC'Pragma: no-cache"); 

// no-cache pour HTTP/1.0 
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header ("Concent -Type: cexc/xml"); 

I //--■ Blocage du Cache 

headerCExpires: Hon, 12 Jul 1995 02:00:00 Cirri; 

// Dace d'explracion aneecleure a la dace accuelle 

header ("last-Hoditled: " . gmdateC'D, dHYH:i:s") . " GHT") ; 

// Indlque de eou]ours modifier la dace 

headec ("Cache-Conccol: no-cache, musc-cevalidece") ; 
'. II no-cache pouc HTTP/1.1 

header ("Pragma: no-cache"); 

// no-cache pour HTTP/1.0 
I // 

(receptlon_x»l - flle_get_contents("php://lnpuC) i 

//recuperation de l'objec XHL dans le riux pp://inpuc 

ftp ■ f open("dleposltlve.xml", "•—) ; //ouvetture du fichier cecepcion.xml 

ireponse-"<?xml version-\"1.0\" encodlng»\"UlP-8\"7>"; //declarclon XHL lnicjale 

il(@£vnce(£fp, firecepcion_xml) ) //test 31 l'ecrlture est correcce 

( sreponse.»"<reponse> ok : 1 ' enregistrement esc effectue </reponse>";) 

else list pb d'ecriture » pteparacion du message d'erreur 

( (reponse.""<reponse> erreur PHP : enreglscremenc non effectue </reponse>";) 
Sreponse»ucf8_encode(5reponse);//codage de la reponse en UTF8 

peine 5iep<mse; /offlchage de la reponse descine a 1'appli Flash 

6fclose(Cfp) ;//fecmecure du Clchler cecepcion.xml 

?> 
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Figure 22-15 

Creation dufichier PHP visionneuse.php avec Dreamweaver 



3. Sous ce code, ajoutez Finstruction qui sert a recuperer le document XML envoye par l'applica- 
tion Flash. Tout le document XML sera ensuite sauvegarde dans la variable $reception_xml 
(Attention ! la recuperation de donnees par le flux PHP ne peut etre utilisee qu'avec la version 4.3 
de PHP ou des versions ulterieures) : 

$recepti on_xml = fi 1 e_get_contents( "php: //input" ) ; 
| // Recuperation de l'objet XML dans le flux php://input 

4. Dans la derniere partie de code, on retrouve alternativement des instructions d'ecriture du fichier 
XML (fopen( ), fwriteO et fcl ose( )) et des instructions destinees a construire la reponse XML 
dont le contenu sera conditionne par le succes de l'operation d'ecriture. Si l'operation d'ecriture 
du fichier XML se deroule correctement, le script affiche a l'ecran le document XML suivant : 

I <reponse> ok : 1 'enregistrement est effectue </reponse> 

5. Si l'ecriture n'est pas possible, le document XML retourne signale une erreur : 

<reponse> erreur PHP : enregistrement non effectue </reponse> 
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A noter 

Pour eviter de perturber renvoi du message d'erreur, les fonctions d'ecriture seront precedees du caractere @ afin 
de neutraliser I'affichage automatique des messages d'erreur a I'ecran. 



// ECRITURE DU FICHIER D I APOS IT I V E . XML ET CONSTRUCTION DE LA REPONSE XML 

$fp = fopenCdiapositive.xml", "w"); // Ouverture du fichier reception. xml 

$reponse="<?xml version=\"1.0\" encoding=\"UTF-8\"?>" ; // Declaration XML initiale 

if (@fwrite($fp, $reception_xml ) ) // Teste si l'ecriture est correcte 

{ $reponse.="<reponse> ok : 1 'enregistrement est effectue </reponse>" ; } 

else // Si probleme d'ecriture >> preparation du message d'erreur 

{ $reponse.="<reponse> erreur PHP : enregistrement non effectue </reponse>" ; } 

$reponse=utf8_encode($reponse) ; // Codage de la reponse en UTF8 

print $reponse; // Affichage de la reponse destinee a 1 'application Flash 

@f cl ose($fp) ; // Fermeture du fichier reception. xml 

?> 

Code complet du fichier visionneuse.php : 
<?php 

headert "Content-Type: text/xml ") ; 

// Blocage du cache 

headerC'Expires: Mon, 12 Jul 1995 02:00:00 GMT"); 

// Date d'expiration anterieure a la date actuelle 

headerC'Last-Modified: " . gmdateC'D, d M Y H:i:s") . " GMT"); 

// Indique de toujours modifier la date 

headert "Cache-Control : no-cache, must-revalidate"); 

// no-cache pour HTTP/1.1 

headert "Pragma : no-cache"); 

// no-cache pour HTTP/1. 0 
// 

$reception_xml = file_get_contents("php://input"); 

// Recuperation de l'objet XML dans le flux php://input 

// ECRITURE DU FICHIER DIAPOSITIVE . XML ET CONSTRUCTION DE LA REPONSE XML 

$fp = fopenCdiapositive.xml", "w"); // Ouverture du fichier reception. xml 

$reponse="<?xml version=\"1.0\" encoding=\"UTF-8\"?>" ; // Declaration XML initiale 

if (@fwrite($fp, $reception_xml ) ) // Teste si l'ecriture est correcte 

{ $reponse.="<reponse> ok : 1 'enregistrement est effectue </reponse>" ; } 

else // Si probleme d'ecriture >> preparation du message d'erreur 

{ $reponse.="<reponse> erreur PHP : enregistrement non effectue </reponse>" ; } 

$reponse=utf8_encode($reponse) ; // Codage de la reponse en UTF8 

print $reponse; // Affichage de la reponse destinee a 1 'application Flash 

@f cl ose($fp) ; // Fermeture du fichier reception. xml 

?> 
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Le document Flash 



Le document Flash doit permettre a l'utilisateur d'afficher les differentes photos et de leur associer un 
commentaire. 

Le scenario principal ne comporte qu'une seule image cle dans laquelle les differents symboles sont 
repartis sur plusieurs caiques. Le code ActionScript est centralise dans l'image 1 du caique Action 
(voir figure 22-16). 



f Macromedia Flash Professional 8 - [visionneuseXml.fla*] 
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1 / / M#MMMM§§MMM$MMM#OBJlT CHARGE HENT XHL 

2 fichier_xnl - new XHL(); 

3 fichier_x»l.ignoreWhite • true; 

4 i ichier_xml.onLoad - funccion(success) ( 

5 l£ (success) < 

6 racme - this . 1 1 rstChi Id; 

7 //cree un pomteur sur la racme xrnl 
image_array ■ new Array (); 

9 commentaire_array ■ new ArrayO; 

10 //creation de 2 tableaux vides pour 

11 totalDiapo - racine.chlldNodes. iengc 

12 //nombre total de diapo 

13 foe (1=0; KtotalDiapo; i++) < 

14 iinage_array[ i] ■ Eftcine.childNoc 

15 //enregistre le nom de l'image c 

16 coirtoentaire_arrayti] ■ racine.cr 
1? //enregistre le nom du commental 

18 > 

19 //fin du for 

20 premiereDiapo() ; 

21 //aitiche la premiere diapo 

22 ) else ( 

23 texteP.eponse_txt.text ■ "Erreur 1 FL 

24 } 

25 >; 

2fi //fm rtii ftMrinnnmr^ I rtAdXHI. 



.igne 118de 118, Col 1 



► BUotheojue 



Figure 22-16 

Creation du document Flash visionneuseXml.fla 



1. Creez un nouveau document Flash et sauvegardez-le sous le nom visionneuseXml . f 1 a dans un 
sous-repertoire du dossier www/SITEf 1 ash/ de votre serveur local (utilisez le meme repertoire que 
celui dans lequel vous avez precedemment enregistre le fichier XML). 
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2. Creez six caiques : Action, Image, Chargeur, Boutons, Message et Fond (voir figure 22-16). 

3. Dans le caique Fond, delimitez 1' interface a Faide d'un element graphique de votre choix et ajoutez 
un titre (Visionneuse de diapositives, parexemple). 

4. Dans le caique Message, creez deux champs texte dynamiques (numero_txt et texteReponse_txt) 
destines a afficher le numero de la diapositive et la reponse renvoyee par le fichier PHP lors de 
Fenregistrement. Creez ensuite un champ texte de saisie (commentai re_txt) destine a afficher le 
commentaire accompagnant chaque diapositive. 

5. Dans le caique Boutons, creez un premier bouton de validation d'enregistrement OK et 
nommez son occurrence boutonl_btn. Creez ensuite deux boutons en forme de fleche afin de 
circuler d'une diapositive a l'autre (suivante ou precedente) et nommez-les droitel_btn et 
gauchel_btn. 

6. Dans le caique Chargeur, creez un clip a partir d'un rectangle qui fera office de barre de chargement. 
Nommez son occurrence chargeurl_mc. 

7. Dans le caique Image, creez une occurrence de clip vide que vous nommerez imagel_mc. Ce clip 
est destine a accueillir les images JPEG des differentes diapositives. 

8. Dans le caique Action, saisissez les differentes parties de code ci-dessous dans l'image cle 1. La 
premiere partie est destinee a creer un objet XML nomme f i chi er_xml dans lequel sera charge le 
contenu du fichier XML diapositive. xml . Le gestionnaire qui controle le chargement cree un 
pointeur racine qui correspond exactement a l'element racine du fichier diapositive. xml (cela 
evite d'avoir a gerer l'element Flash-root genere automatiquement par Flash dans l'objet XML). 
Ensuite, deux tableaux de variables (image_array et commentai re_array) sont declares afin 
d'accueillir les contenus des elements <image> et <commentai re> de chaque diapositive. Une varia- 
ble total Diapositives est initialisee avec le nombre d'elements <diapo> charges. A la ligne 
suivante, cette meme variable est utilisee dans F expression de condition de la structure de boucle 
for. Cette structure de boucle permet d'affecter successivement les differentes images et 
commentaires aux deux tableaux precedemment crees. Une fois que la boucle a parcouru tous les 
elements <diapo> charges, une fonction premiereDiapositive( ) est appelee afin d'afficher la 
premiere diapositive de la serie. Enfin, en cas de probleme de chargement, la zone de texte 
texteReponse_txt affichera un message d'erreur : 

//################0BJET CHARGEMENT XML 
fichier_xml = new XMLO; 
fichier_xml .ignoreWhite = true; 
fichier_xml .onLoad = function(succes) { 
if (succes) { 

racine = this.firstChild; 

// Cree un pointeur sur la racine xml du document source 
image_array = new ArrayO; 
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commentai re_array = new ArrayO; 

// Creation de deux tableaux vides pour les images et commentai res 

totalDiapositives = racine.childNodes. length; 

// Nombre total de diapositives 

for (i=0; i<total Diapositives; i++) { 

image_array[i ] = racine.childNodes[i].childNodes[0].firstChild.nodeVa!ue; 
// Enregistre le nom de 1 'image dans le tableau image_array 
commentai re_array[i ] = racine.chi 1 dNodes[i ] . chi 1 dNodes[l] .f i rstChi 1 d . 
**nodeVal ue; 

// Enregistre le nom du commentaire dans le tableau commentai re_array 



} 

}; 

// Fin du gestionnaire loadXML 

9. La seconde partie du code a pour but de creer un autre objet XML, reponse_xml , qui sera exploite 
pour recuperer la reponse renvoyee au format XML par le script PHP. Cette reponse peut etre soit 
un message de confirmation si Fenregistrement du fichier XML est coiTect, soit un message 
d'erreur dans le cas contraire. La declaration de Fobjet et le gestionnaire de chargement sont 
identiques a ceux de l'objet XML precedent, hormis le fait qu'ici on recupere le contenu du 
message pour l'affecter au champ texte texteReponse_txt afin que le message soit affiche dans 
l'interface (au-dessus des deux autres champs texte) : 

//################0BJET REPONSE XML 
// Creation de l'objet reponse_xml 
var reponse_xml = new XMLO; 
reponse_xml .ignoreWhite = true; 
reponse_xml .onLoad = function(succes) { 
if (succes) { 

texteReponse_txt.text = this .fi rstChild.fi rstChild.nodeVal ue; 
chargement( ) ; 
} else { 

texteReponse_txt.text = "Erreur 2 FLASH"; 



// Fin du for 



premiereDiapositive( ) ; 

// Affiche la premiere diapositive 



el se { 



texteReponse_txt.text = "Erreur 1 FLASH"; 



}; 
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10. La partie suivante est dediee ail moteur de chargement des fichiers JPEG. Cette structure s'appuie 
sur un gestionnaire onEnterFrame qui scrute en permanence le chargement des images afin de 
faire evoluer la dimension de la barre de chargement tant que celui-ci est en cours, puis qui 
augmente progressivement 1' alpha des images a partir du moment oil elles sont completement 
chargees : 

//mmmmmmmojEUR du chargeur 

_root. onEnterFrame = functionO { 
chargeurl_mc._visible = true; 
chargeTotale = imageljic.getBytesTotal ( ) ; 
chargeActuel 1 e = imagel_mc.getBytes Loaded ( ) ; 
if (chargeActuelle != chargeTotale) { 

_root.chargeurl_mc._xscale = 100*chargeActuelle/chargeTotale; 
// Augmente progressivement la taille du voyant pendant le chargement 
} else { 

chargeurl_mc._visible = false; 
if (imagel_mc._alpha<100) { 

imagel_mc._alpha += 10; 
// Augmente progressivement 1 'alpha de la photo des qu'elle est completement 
^•chargee 

} 

} 

}; 

11. Ajoutez a la suite le code ci-dessous afin d' assurer la gestion du bouton de memorisation (bouton 
OK), du bouton Diapositive suivante et du bouton Diapositive precedente : 

//###################GESTI0N DES B0UT0NS 
boutonl_btn.onRelease = functionO { 
memorisation( ) ; 

}; 

gauchel_btn.onRelease = functionO { 
precedentDiapositive( ) ; 

}; 

droitel_btn.onRelease = functionO { 
suivantDiapositive( ) ; 

}; 

12. La fonction de chargement est executee des l'appel de 1' animation et a chaque fois qu'un 
commentaire est memorise. Elle initialise a zero l'indice n qui controle les diapositives et 
declenche le chargement du fichier diapositi ve.xml dans l'objet fichier^xml grace a la methode 
loadO : 

//mmmmmmtmcnoH chargement 

function chargementO { 
n = 0; 

// Initialisation de l'indice de diapositive 
f i chier_xml . 1 oad( "di aposi ti ve.xml " ) ; 

} 
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13. La fonction de memorisation est appelee par une action sur le bouton OK (boutonl_btn). 
Elle permet d'affecter le contenu du commentaire modifie a la valeur de l'element <commen- 
taire> correspondant a la diapositive en cours de consultation (specifiee par l'indice n). 
La methode sendAndLoad( ) est ensuite appelee arm d'envoyer le document modifie vers le script 
vi si onneuse . php et d' assurer la recuperation de la reponse de ce meme script dans le second objet 
XML reponse_xml. Enfin, l'ancien objet fichier_xml est supprime avant d'etre recree avec le 
contenu telecharge depuis le fichier XML modifie (chargement effectue par l'appel de la fonction 
chargement( ) appelee a la fin du gestionnaire de Fobjet reponse_xml) : 

//#####f############f#F0NCT ION MEMORISATION 

// Memorisation du commentaire d'une diapositive 

function memorisation( ) { 

f i chier_xml . f i rstChil d .chi 1 dNodes[n] . chi 1 dNodes[l] . f i rstChi 1 d.nodeVal ue 
_root.commentaire_txt.text; 

f i chier_xml . send And Load ( "vi si onneuse. php" , reponse_xml ) ; 

delete fichier_xml; // Suppression de 1 'objet XML 

} 

14. Les autres fonctions destinees a la gestion des diapositives sont rassemblees a la fin du script de 
l'image cle (voir le code ci-dessous). Elles permettent de passer a la diapositive suivante lors d'un 
clic sur la fleche de droite (suivantDiapositive( )), de revenir a la diapositive precedente lors 
d'un clic sur la fleche de gauche (precedentDiapositivet )) ou encore de retourner a la premiere 
diapositive apres l'enregistrement d'un commentaire ou lors de la premiere ouverture de 1' appli- 
cation Flash (premiereDiapositive( )). Pour chacune de ces trois fonctions, le deroulement est 
semblable : 

- F alpha du clip conteneur est initialise a zero ; 

- l'image est chargee a l'aide d'une methode loadMovie( ) ; 

- le texte du commentaire de la diapositive est affecte a la zone texte commentai re_txt ; 

- l'affichage du numero de la diapositive est assure par l'appel de la fonction numeroDiaposi- 
ti ve( ) placee a la fin de cette partie de code : 

//##############T0UTES LES FONCTIONS GESTION DES DIAPOSITIVES 
function suivantDiapositive( ) { 

texteReponse_txt.text = "; 

// Initialisation zone reponse 

if (n<(totalDiapositives-l)) { 
n++; 

if (chargeActuelle == chargeTotal e) { 
imagel_mc._alpha = 0; 
imagel_mc.loadMovie(image_array[n] , 1) ; 
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commentai re_txt . text 
numeroDiapositive( ) ; 



commentai re_array [n] ; 



} 

function precedentDiapositive( ) { 
if (n>0) { 
n-- ; 

imagel_mc ._al pha = 0; 
imagel_mc.loadMovie(image_array[n] , 1) ; 
commentai re_txt .text = commentai re_array[n] ; 
numeroDi apositi ve( ) ; 

} 

} 

// 

function premiereDiapositive( ) { 

if (chargeActuel 1 e == chargeTotal e) { 
imagel_mc._alpha = 0; 
imagel_mc.loadMovie(image_array[0] , 1) ; 
commentai re_txt. text = commentai re_array[0] ; 
numeroDi apositi ve( ) ; 

} 

} 

// 

function numeroDi apositi ve( ) { 
num = n+1 ; 

numero_txt.text = num+" / "+totalDiapositive; 

} 



15. Enfin, a la derniere ligne du script, se trouve l'appel de la fonction de chargement initial (charge- 
ment( )) qui permet de charger dans Fobjet fichier_xml le contenu du fichier diapositive.xml des 
Fouverture de F application Flash : 

/ /iHHHHHHHHHHHHHHHHHHHHHHHHtk PPEL FCT 
chargement( ) ; 

// Appelle la fonction au debut de 1 ' appl i cation 

16. Une fois que vous avez termine de saisir le script dans 1' image cle, enregistrez votre document 
Flash et publiez-le dans le meme repertoire. Vous pouvez desormais passer dans le Web local 
pour tester le fonctionnement de Fensemble du systeme (voir figure 22-17). Si vous installez 
cette application sur un serveur distant, assurez-vous que le fichier diapositive.xml dispose bien 
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des droits d'ecriture (utilisez si besoin CHMOD pour les modifier) et que la version du PHP 
est ulterieure a la version 4.3 (utilisez si besoin la fonction phpinfoO pour ce faire) afin que 
1' instruction de recuperation du flux PHP puisse etre interpretee correctement 
(f i 1 e_get_contents( "php: //input" )). 
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Figure 22-17 

Test de la visionneuse de diapositives dans le Web local 
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Interface Flash-XML-PHP-MySQL 

Dans le chapitre 18 sont presentes des interfaces Flash-PHP-MySQL utilisant la classe LoadVars et 
ses methodes pour recuperer des informations retournees par une base de donnees. Cependant, les 
applications de cette technique d'interfacage restent limitees a des echanges de petites quantites de 
variables simples. 

Une autre solution consiste a utiliser la classe XML couplee a un script PHP qui a pour fonction de 
mettre les informations issues de la base de donnees au format XML. Les informations extraites de 
la base de donnees peuvent ainsi conserver leur structure grace a une construction adaptee du docu- 
ment XML. D' autre part, comme pour toutes les informations recuperees par Flash au format XML, 
il est beaucoup plus facile d'en extraire les donnees desirees a l'aide des nombreuses methodes de 
la classe XML. 

Avec cette technique, le XML n'est plus exploite comme une solution d'archivage des donnees qui 
serait une alternative a Futilisation d'une base de donnees, mais comme une solution de transfert 
parfaitement adaptee a la structure d'une base MySQL. 
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Figure 22-18 

Principe de Vinterface Flash-XML-PHP-MySQL utilisee pour V application du systeme de signets dynamiques 



Systeme de signets dynamiques 

Nous allons utiliser cette technique d'interfacage pour realiser un systeme de signets dynamiques. 

Les signets seront archives dans la table d'une base de donnees MySQL. La mise a jour des donnees 
dans une base MySQL ay ant deja ete traitee a plusieurs reprises (revoir le chapitre 18), nous ne 
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detaillerons pas l'actualisation ou l'ajout des signets dans une base mais cette fonctionnalite pourra 
etre facilement integree ail systeme dans un second temps. 

Un script PHP assure la jonction entre la base MySQL et F application Flash. Lorsque 1' application 
Flash lui envoie (en parametre d'URL) un mot-cle a rechercher parmi les noms des signets, il Finte- 
gre dans une requete SQL qu'il soumet a la base de donnees. En sens inverse, lorsque la base de 
donnees lui retourne le resultat dans un jeu d'enregistrements, il construit une structure de document 
XML dans laquelle les informations de chaque enregistrement sont integrees. Des que ce document 
est termine, il est affiche dans le navigateur arm que Fapplication Flash puisse le charger dans un 
objet XML adapte (voir figure 22-18). 

Une fois les donnees disponibles dans Fapplication Flash, il suffit d'utiliser les procedures d' analyse 
XML presentees dans le chapitre precedent pour en extraire les informations. Celles-ci seront ensuite 
mises en forme (au format HTML afin de pouvoir creer des liens hypertextes) avant d'etre affichees. 
Le controle des erreurs eventuelles et le nombre de signets trouves seront affiches dans un champ 
texte situe au-dessus de la zone d'affichage des resultats. 

La base de donnees MySQL 

La base de donnees MySQL utilisee dans cette application se nomme mesf avori s_db. Elle stocke les 
parametres de chaque signet et permet d'effectuer une recherche du ou des signets correspondants. 
Elle est constituee d'une seule table nommee signets qui comporte elle-meme quatre champs : une 
cle primaire (ID), FURL de chaque signet, le nom et la description du signet. 

1 . Creation de la base de donnees : ouvrez le gestionnaire de base de donnees phpMy Admin (depuis 
le manager de Wamp, selectionnez Foption phpMy Admin). Dans le champ de saisie du cadre 
central, saisissez le nom de la nouvelle base mesf avori s_db, puis cliquez sur le bouton Creer 
(revoir si necessaire le chapitre 16 dedie a phpMy Admin). 

2. Creation de la table signets : selectionnez la base de donnees mesf avori s_db dans le menu 
deroulant du cadre de gauche. Dans la partie droite, selectionnez Fonglet Structure puis, au 
niveau de la rubrique Creez une nouvelle table, saisissez signets (nom de la table a creer) 
dans le champ nom puis le chiffre 4 pour preciser le nombre de champs a creer. Cliquez 
sur Executer afin d'acceder au formulaire de creation des champs. Renseignez le formulaire 
comme indique par la figure 22-19 puis validez vos choix en cliquant sur le bouton Sauve- 
garder. 



A noter 

Une autre solution pour creer la table signets consiste a saisir (ou a coller) le code SQL indique ci-dessous dans le 
champ dedie aux requetes de Fonglet SQL (revoir si besoin les techniques de restauration d'une base de donnees 
au chapitre 6). Si vous souhaitez utiliser cette methode, unfichier nomme signets.sql comportant ce code SQL 
se trouve a la racine des ressources concernant cette application. 
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Figure 22-19 

Creation de la table signets dans le gestionnaire phpMyAdmin 



3. Inserez des enregistrements dans la table : afin de pouvoir tester le systeme, vous devez inserer 
plusieurs enregistrements dans la table en vous assurant ail prealable que les URL sont bien vali- 
des (voir les exemples d'enregistrement de la figure 22-20). Une fois que vous aurez ajoute vos 
signets dans la base, fermez le gestionnaire et passez a la creation du fichier PHP. 

Code SQL correspondant a la creation de la table signets : 

CREATE TABLE "signets" ( 

~ID~ smal 1 int(6) NOT NULL auto_increment, 
'urV varchar(200) NOT NULL default ". 
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~nom~ varchar(lOO) NOT NULL default 
"descriptiT text NOT NULL, 
PRIMARY KEY ("ID*) 
TYPE=MyISAM AUT0_INCREMENT=6 ; 
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Figure 22-20 

Exemple d'enregistrements de signets ajoutes dans la base de donnees pour les tests 



Le fichier PHP 

Le fichier visionneuse.php a pour fonction de recuperer le document XML modifie, de l'enregistrer 
dans le fichier diapositive.xml puis de construire et de retourner une reponse XML qui confirme que 
l'operation d' enregistrement s'est bien deroulee ou qui indique la nature du probleme si ce n'est pas 
le cas. 

1. Creez un nouveau document PHP dans Dreamweaver et sauvegardez-le sous le nom 
si gnetsXml . php dans un sous-repertoire du dossier www/SITEf 1 ash/ de votre serveur local (utilisez 
par exemple le sous-repertoire /6-xml /chap22/signetsDynamiques/). 

2. Saisissez les instructions ci-dessous afin d'initialiser la variable $clause qui sera envoyee en 
parametre d'URL par F application Flash (voir figure 22-21) : 

I <?php 

// Initialisation des variables 

i f (i sset($_GET[ 'cl ause' ] ) ) $cl ause=$_GET[ ' cl ause' ] ; else $clause="inconnu" ; 



XML avec Flash et PHP 

Partie VI 



9 Macromedia Dreamweaver 8 - [C:\wdmp\www\SITEfla5h\6 xml\chdp22\signetsDynajniques\5ignel5Xnil.php (XHTML)] 
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3 if (isset((_GETt 'clause* )) ) ( clause *(_G£T( 'clause' J; else (clause»"mconnu"; 

WSM // Conf iguration de la connexion MySQL 

5 ■ysql_connect("localhost","Eoot",'"*) oc dle( '<eEEeuE>Connexion HySQL i«po3sible</eEEeuE> ' ) ; 

6 Bysql_3elecc_db("»e3£avo£i3_db") or die( *<eEEeuE>Base de donnees lnaccesslble</erteuE> ' J ; 

//- Construction de la teqete SQL 

8 If ( (SclttUSe! •"inconnu")tt(*cl*U9e !«"")) 

9 (queEy_EsFavoEis«"SELECT ■ FROM signets UHEPE noa LIU (clause. *'% '"; 

10 else //si la clause n'esc pas definie ou est vide 

11 ( que Ey_EaFevoEis»'* SELECT • FROM signets"; //selectionne tous les signets 

12 // Envoi de la t equate SQL au setveut 

13 (rsFavorls - ■ysql_qjueEy(Struery_rsFavorls) or die( <etteuE>' .(»ysql_erEOE{) . ^/erreurV ); 

14 // Construe tuion du fichlet resultats en XML 

15 (tesultat_xal » '<?x*l veESion»"1.0" encoding- "UTF-8" ?>■; 

16 (resultatjcal .-'<*esfavoEi3 nb-" ' .»y3ql_nu»_EOM3((rsFavoEi3) . "*> ' ; 

X? //Deux boucles labciquees sont utilisees pout tecupetet les tesultats 

18 //des tlgnes ((ligne) et des colonnes ((col) de la base de donnees 

19 fot((ligne > 0; (ligne < aysql_nuB_tovs((EsFavoris) ; Sligne++)( 

20 (Eesultat_x«l .* '<signet>'j 

21 (EO«»_EsFavoEiS" »ysql_fetch_EOH((ESFavoEis) ; 

22 //pout tous les cheaps 

23 for ((col ■ 0; (col < »ysql_nu»_fields((rsF«votist; trcalil] 

24 (Eesultat_x«l .» '<lnfo na»e=" " .aysql_Cield_na»e (( EsFavoEis ( (col) . 1 "> ' .utC8_encode ( 
(to«_tsFavoEis[(col]). *</info>' ; 

25 (tesultat_xml »■ '</signet>'; 

26 > 

27 (tesultat_xi»l .- '</mesfavoEis>'; 

28 »ysql_f nee_Eesult((tsFttvoti3) ; 

ggj // — Le teaultat (au to»at XML) est affiche ef in que Flash puisse le 

recuperet 
30 echo (resultet xal; 
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Figure 22-21 

Creation du fichier PHP signetsXml.php avec Dreamweaver 



3. Sous ce code, ajoutez les instructions necessaires a la connexion a la base MySQL. 
// Configuration de la connexion MySQL 

mysql_connect("localhost","root",'"') or die( '<erreur>Connexion MySQL impossible</erreur>' ) ; 
1 mysql_select_db("mesfavoris_db") or die( '<erreur>Base de donnees inaccessible</erreur>' ) ; 



A noter 

Cette application etant isolee, nous n'utiliserons pas de fichier de connexion externe, mais integrerons directe- 
ment dans le script les instructions et parametres de connexion. Pour les tests, nous utilisons I'utilisateur root 
(sans mot de passe) present par defaut dans la base de donnees MySQL. Si vous decidez d'utiliser cette appli- 
cation en ligne, vous devrez creer un utilisateur specifique et modifier le nom de I'utilisateur et son mot de passe 
dans ces parametres. 
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4. La partie de code ci-dessous permet de construire la requete SQL en integrant la variable $cl ause. 
L'integration de cette variable est conditionnee par sa disponibilite. Ainsi si la variable n'existe 
pas ou est vide, la requete sera creee sans clause WHERE afin de selectionner tous les enregistrements 
de la table : 



if ( ($cl ause!="inconnu ")&&($ clause!="" ) ) 

$query_rsFavoris="SELECT * FROM signets WHERE nom LIKE ' %" . $cl ause. "% " ; 
else // Si la clause n'est pas definie ou est vide 

$query_rsFavoris="SELECT * FROM signets"; // Selectionne tous les signets 

5. Une fois la requete elaboree, elle doit etre envoyee au serveur MySQL a l'aide de la fonction 
mysql_query( ) : 

// Envoi de la requete SQL au serveur 

SrsFavoris = mysql_query($query_rsFavoris) or die( '<erreur>' .$mysql_error( ) . '</erreur>' ) ; 

6. Le jeu d' enregistrements retoume par la base MySQL doit ensuite etre integre dans un fichier 
XML afin que ses donnees puissent etre analysees par 1' application Flash. Le script suivant 
permet de construire ce fichier XML d'une maniere dynamique. II est constitue de deux boucles 
imbriquees qui permettent de creer des elements signets en recuperant les lignes et les colonnes 
du jeu d' enregistrements (IrsFavori s) retoume par la base de donnees : 

// Construction du fichier resultats en XML 

$resul tat_xml = '<?xml version="1.0" encoding="UTF-8" ?>'; 
$resul tat_xml .='<mesfavoris nb=" ' .mysql_num_rows($rsFavoris) .'">'; 
//Deux boucles imbriquees sont utilisees pour recuperer les resultats 
// Des lignes ($ligne) et des colonnes ($col) de la base de donnees 
for($ligne = 0; $ligne < mysql_num_rows($rsFavoris) ; $ligne++){ 

$resul tat_xml .= '<signet>'; 

$row_rsFavori s= mysql_fetch_row($rsFavoris) ; 

// Pour tous les champs 

for($col = 0; $col < mysql_num_fields($rsFavoris) ; $col++) 
$resultat_xml .= '<info name=" ' .mysql_field_name($rsFavoris,$col ).'">' .utf8_encode 

**($row_rsFavoris[$col ] ) . ' </i nfo> ' ; 
$resul tat_xml .= '</signet>'; 

1 

$resul tat_xml .= '</mesfavoris>' ; 
mysql_f ree_resul t( SrsFavori s ) ; 

7. La derniere ligne du script PHP affiche le document XML precedemment cree afin qu'il puisse 
etre recupere puis analyse par l'application Flash : 

I // Le resultat (au format XML) est 

// Affiche afin que Flash puisse le recuperer 
echo $resul tat_xml ; 



// 



Construction de la requete SQL 



XML avec Flash et PHP 

Partie VI 



Code complet du fichier signetsXml .php : 
<?php 



II Initialisation des variables 

if(isset($_GET['clause'])) $clause=$_GET[' clause']; else $clause="inconnu"; 
// Configuration de la connexion MySQL 

mysql_connect("localhost","root","") or die( '<erreur>Connexion MySQL impossible</erreur>' ) ; 
mysql_select_db("mesfavoris_db") or die( '<erreur>Base de donnees inaccessible</erreur>' ); 
// Construction de la requete SQL 



if ( ($clause!="inconnu" )&&($clause!="" ) ) 

$query_rsFavoris="SELECT * FROM signets WHERE nom LIKE '%" .$cl ause. "%'" ; 
else // Si la clause n'est pas definie ou est vide 

$query_rsFavoris="SELECT * FROM signets"; // Selectionne tous les signets 
// Envoi de la requete SQL au serveur 

SrsFavoris = mysql_query($query_rsFavoris) or die( ' <erreur>' . $mysql_error( ) . '</erreur>' ) ; 

// Construction du fichier resultats en XML 

$resultat_xml = '<?xml version="1.0" encoding="UTF-8" ?>'; 
$resultat_xml .='<mesfavoris nb=" ' .mysql_num_rows($rsFavoris) .'">'; 
// Deux boucles imbriquees sont utilisees pour recuperer les resultats 
// des lignes (Sligne) et des colonnes ($col) de la base de donnees 
for($ligne = 0; Sligne < mysql_num_rows($rsFavoris) ; $ligne++){ 

Sresul tat_xml .= '<signet>'; 

$row_rsFavoris= mysql_fetch_row($rsFavoris) ; 

// Pour tous les champs 

for($col = 0; $col < mysql_num_fields($rsFavoris) ; $col++) 
$resul tat_xml .='<info name="' .mysql_field_name($rsFavoris,$col ).'">' 
*».utf8_encode($row_rsFavoris[$col ]) . '</info>' ; 
$resultat_xml .= '</signet>'; 

} 

$resultat_xml .= '</mesfavoris>' ; 
mysql_free_result($rsFavoris) ; 

// l_ e resultat (au format XML) est affiche afin que Flash puisse 

**le recuperer 
echo $resul tat_xml ; 
?> 

Le document XML renvoye par le script PHP 

Dans cette interface, il n'existe reellement pas de fichier XML. Cependant, il est interessant de 
connaitre la structure du document XML renvoye par le script PHP. Pour Fafficher, il suffit d'appeler 
le fichier PHP si gnetsXml . php. Vous obtiendrez alors un document XML comprenant tous les signets 
enregistres dans la table. Si vous ajoutez le parametre d'URL clause a la suite du nom du fichier 
comme dans l'exemple ci-dessous, vous obtiendrez la selection des enregistrements correspondants 
formates en XML (voir figure 22-22) : 

| signetsXml .php?clause=php 



A noter 

Ce test est aussi un excellent moyen de s'assurer du bon fonctionnement du script PHP... 
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<?xml version="1.0" encoding="UTF-8" ?> 
- <mesfavoris nb="3"> 
- <signet> 

<info name="ID">3</info> 

<info name="url">www.phpmx.com</info> 

<info name="nom">PHPmx</info> 

<info name="descriptif">phpmx, la puissance du PHP au service de 
Dreamweaver et de flash MX 2004</info> 



- <signet> 

<info name="ID">4</info> 

<info name="url"> www. easy php.org</info> 

<info name="nom">EasyPhp</info> 

<info narne="descriptif ">EasyPHP is a complete software package allowing 
to use with the dynamic language PHP</info> 



- <signet> 

<info name="ID">5</info> 

<info name="url"> ww w .php .net</mfo> 

<info name="nom">Ressource PHP</info> 

<info name="descriptif">Documentation et exemples de script PHP.</info> 

</signet> 
</mesfavoris> 



Termine * J Intranet local 

Figure 22-22 

Document XML affiche lors de I'appel dufichier PHP signetsXml.php avec le parametre d'URL clause=php 

Le document Flash 

Le document Flash permet a l'utilisateur de saisir le nom du signet (ou une partie de ce nom) et de 
consulter en retour une liste des signets. Si la fenetre ne peut afficher tous les signets, deux boutons 
places lateralement permettent de monter ou de descendre dans la liste afin de consulter les signets 
non visibles. Le champ de l'URL de chaque signet est parametre pour ouvrir une nouvelle fenetre de 
navigateur affichant le site du signet concerne par un simple clic (voir figure 22-24). 

Le scenario principal ne comporte qu'une seule image cle dans laquelle les differents symboles sont 
repartis sur plusieurs caiques. Le code ActionScript est centralise dans l'image du caique Acti on. 

1. Creez un nouveau document Flash et sauvegardez-le sous le nom signetsXml .fl a dans un sous- 
repertoire du dossier www/SITEf 1 ash/ de votre serveur local (utilisez le meme repertoire que celui 
dans lequel vous avez precedemment enregistre le fichier PHP). 



</signet> 



</signet> 
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J Macromedia Flash Professional 8 - [signelsXml.fla*] 
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Figure 22-23 

Creation du document Flash signets.fla 



2. Creez cinq caiques : Action, Boutons, Resultats, Formulaire et Fond (voir figure 22-23). 

3. Dans le caique Fond, delimitez Finterface avec un element graphique de votre choix et ajoutez un 
titre (Signets dynamiques, parexemple). 

4. Dans le caique Formulaire, creez un champ texte de saisie (clause_txt) pour saisir le nom du 
signet a rechercher. 

5. Dans le caique Resultats, creez un premier champ dynamique multiligne d'occurrence 
resultat_txt et dont le nom de variable (champ Var) sera nomme resultat. Configurez ensuite 
son panneau Proprietes afin que ce champ puisse afficher du texte au format HTML. Creez un 
second champ dynamique d'occurrence message_txt place au-dessus du premier afin de pouvoir 
afficher les messages retournes par le fichier PHP (le message retoume peut etre soit le nombre 
d'enregistrements, soit un message d'erreur). 

6. Dans le caique Boutons, creez un premier bouton de validation d'enregistrement OK et nommez 
son occurrence boutonl_btn. Creez ensuite deux boutons en forme de fleche afin de parcourir la 
liste des signets et nommez-les hautl_btn et basl_btn. 
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7. Dans le caique Action, saisissez le code ci-dessous dans l'image cle 1. La premiere partie est 
destinee a la gestion des trois boutons de F application. Le bouton OK permet de declencher une 
action de chargement XML (methode 1 oad( )) en envoyant en parametre d'URL la clause saisie 
par l'utilisateur. Les deux autres boutons (les deux fleches) permettent de gerer le scroll de la liste 
resul tat_txt : 

// 

// Gestion du bouton OK 
boutonl_btn.onRelease = functionO { 

clause = _root.clause_txt.text; 

monDoc_xml . 1 oad( "signetsXml . php?cl ause="+cl a use) ; 

}; 

// 

// Gestion du bouton haut 
hautl_btn.onRelease = functionO { 
resultat_txt. scroll -= 1; 

}; 

// 

// Gestion du bouton bas 
basl_btn.onRelease = functionO { 
resultat_txt. scroll += 1; 

}; 

8. La partie suivante cree puis configure Fobjet XML monDoc_xml afin de pas tenir compte des even- 
tuels espaces dans le document XML qui sera charge : 

// 

// Creation de l'objet XML 
monDoc_xml = new XMLO; 
// Declaration de l'objet XML 
monDoc_xml .ignoreWhite = true; 
// Ignorer les sauts de ligne 

9. La creation de l'objet XML est suivie du gestionnaire on Load ( ). Les deux premieres instructions 
du gestionnaire permettent de creer un pointeur raci ne et de recuperer le nombre de signets dans 
une variable nbsi gnets. Apres ces deux instructions, une structure de choix i f permet d'initialiser 
la valeur du champ message_txt grace a un texte qui indique le nombre de signets ou un message 
d'erreur (si l'element racine retourne par le script PHP se nomme erreur). La suite concerne 
l'elaboration du resultat (au format HTML) qui sera affiche dans la zone de texte dynamique 
resultat : 

// Gestionnaire d ' evenements onLoad XML 
monDoc_xml .onLoad = function(succes) { 
if (succes) { 

var racine : Object = this.fi rstChi Id; 

// Pointe sur l'objet racine (mesfavoris) 

var nbsignet = racine. attributes. nb; 
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II Recuperation du nombre de resultats 
if ( racine.nodeName == "erreur") { 

// Gestion des eventuelles erreurs 
messagejxt.text = racine.firstChild.nodeValue; 
} else { 

// Si pas d'erreur, affiche le nombre de resultats 
message_txt.text = "II y a "+nbsignet+" resultat(s)"; 



if (nbsignet == 0) { 

// S'il n'y a aucun resultat 
resultat = "II n'y a pas de reponse<br>Merci de renouveler votre requete 
*»avec un autre mot cle"; 



// Sinon construction HTML des resultats 
resultat = ""; 

for (var n = 0; n<racine.childNodes. length; n++) { 

resultat += "<font color=\"#FF0000\" s1ze=\"l4\" Face=\"Arial \"><b>" ; 
resultat += racine.childNodes[n].childNodes[2].firstChild.nodeValue; 

// Norn du signet 

resultat += "</b></font>" ; 

resultat += "<br><i> "; 
resultat += racine.childNodes[n].childNodes[3].firstChild.nodeValue; 

// Descriptif du signet 
resultat += "</i><br> <font col or=\"#0000FF\" size=\"12\" Face=\"Arial 
*A"> <a href='http://"; 

resultat += racine.childNodes[n] .childNodes[l].firstChild.nodeValue; 
resultat += "' target='_blank' >"; 
// Lien hypertexte de l'URL du signet 
resultat += racine.childNodes[n] .childNodes[l].firstChild.nodeValue; 
// Affichage del 'URL du signet 
resultat += "</a></font><br>" ; 

resultat += " "; 

resultat += "<br>" ; 
} // Fin du for 



// 



Gestion du resultat 



} else { 



} // Fin du else 
} // Fin du if(succes) 
}; // Fin du gestionnaire 



10. Une fois que vous aurez saisi tout le code dans Fimage cle, enregistrez votre animation et passez 
dans le Web local pour tester l'interfacage complet. Pour ce faire, saisissez un mot-cle puis 
cliquez sur le bouton OK. Tous les signets dont le nom comporte le mot-cle doivent etre affiches 
dans la zone des resultats (voir figure 22-24). Si vous cliquez sur FURL d'un signet, la page Web 
correspondante doit s'afficher dans une nouvelle fenetre. 
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Test de 1 'application des signets dynamiques dans le Web local 



Interface Flash-XML-Serveur Socket PHP 

A la fin du chapitre 20, nous avons presente la classe XMLsocket et ses methodes. Nous allons illus- 
trer le fonctionnement de ces methodes dans le cadre d'une petite application de dialogue en ligne 
(chat). Pour utiliser un objet XMLsocket, il faut avant tout disposer d'un serveur socket. De 
nombreux serveurs socket sont compatibles avec F utilisation des methodes XMLsocket de Flash, 
mais nous avons decide de retenir un serveur programme en PHP en raison du theme de ce livre 
meme si cette solution n'est pas la plus performante. Les fonctions utilisees dans ce serveur socket 
PHP depassent le cadre de cet ouvrage et nous ne detailleront pas son fonctionnement. Nous nous 
limiterons au parametrage d'un serveur socket PHP dont le code source est disponible sur le site 
Internet de son auteur (www.your-socket.com). 
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Un systeme de dialogue en ligne (chat) 

Un systeme de dialogue en ligne permet a plusieurs personnes connectees simultanement sur le 
meme site de dialoguer en direct. Dans la version de chat que nous allons presenter, chaque message 
envoye par un utilisateur s'affichera sur les ecrans de tous les utilisateurs connectes. Le but de cette 
application est de vous presenter un exemple tres simple d' utilisation d'un serveur socket arm que 
vous en apprehendiez le concept et non de developper une application elaboree. 

Le document Flash 

Le premier ecran de l'application Flash permet a l'utilisateur de declarer son pseudo afin d'acceder a 
Fespace de dialogue en ligne. Dans le second ecran, un champ texte de saisie lui permet de saisir son 
message puis de Fenvoyer au serveur socket. Des reception du nouveau message, le serveur socket 
diffuse celui-ci a toutes les applications connectees (dont celle de Femetteur du message). Tous les 
messages receptionnes par l'application sont affiches dans une zone texte dynamique selon l'ordre de 
reception. 

La structure du document Flash est simplifiee a 1' extreme afin que vous compreniez Futilite de 
chaque variable ou fonction. Vous pourrez ainsi adapter facilement cette application de base a vos 
projets personnels. 

1 . Creez un nouveau document Flash et sauvegardez-le sous le nom chat . f 1 a dans le repertoire C : / 
SITEchat/de votre ordinate ur. 

2. Creez cinq caiques : Label, Action, Boutons, Message et Fond. 

3. Dans le caique Label, nommez la premiere image cle Identi f i cati on. Creez une image cle dans 
les images 10, 20 et 30. Nommez ensuite l'image 10 Dialogue et Fimage 20 Erreur. 

4. Dans le caique Fond, delimiter 1' interface grace a un element graphique de votre choix et ajoutez 
un titre (D1 al ogue en di rect, par exemple). Creez ensuite une image cle dans Fimage 30. 

5. Dans le caique Message, placez-vous dans Fimage 1 et creez un champ texte de saisie pseudo_txt 
destine a saisir le pseudo. Creez ensuite une image cle dans les images 10, 20 et 30. Dans Fimage 
cle 10, ajoutez en haut de Fecran un champ texte dynamique pseudo_txt destine a afficher le 
pseudo de l'utilisateur precedemment declare. Au centre de Fecran, ajoutez un champ de texte 
dynamique multiligne 1 i ste_txt destine a accueillir la liste des differents messages recus par le 
serveur socket. Enfin, en bas de Fecran, ajoutez un dernier champ de texte de saisie message_txt 
qui permettra a l'utilisateur de saisir son message. Placez-vous dans l'image cle 20 et ajoutez au 
milieu de Fecran un champ de texte dynamique nomme erreur_txt qui aura pour fonction d' affi- 
cher les eventuelles erreurs de connexion rencontrees. 

6. Dans le caique Boutons, placez-vous dans l'image cle 1 et creez un premier bouton de validation 
du pseudo et nommez son occurrence boutonl_btn. Creez ensuite une image cle dans les images 
10, 20 et 30. Placez-vous dans l'image cle 20 et creez un second bouton bouton2_btn a droite du 
champ texte de saisie message_txt afin de permettre a l'utilisateur de valider son message et de 
declencher son envoi vers le serveur socket. 
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Dans le caique Action, saisissez le code ci-dessous dans l'image cle 1 (voir figure 22-25). La 
premiere partie est destinee a initialiser les parametres du serveur socket. La variable adresseSer- 
veur correspond a Fadresse du serveur (adresse IP ou domaine). Dans notre cas, nous initialisons 
cette variable avec la valeur 1 ocal host car nous desirons tester notre systeme en local. La seconde 
variable numPort permet de definir quel port du serveur est configure pour rester a Fecoute des 
application Flash (ce port doit etre superieur ou egal a 1 024) : 



^FIGURATION 
adresseServeur = "1 ocal host" ; 
// Adresse du serveur local 
numPort = 22222; 

// Numero du port d'ecoute du serveur socket 
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7 tnon0tojet_xinl3ocket - new XHLSocket ( 
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11 var chargement_x»l - new XHL (do 

12 // creation d'un objet XRL pour 

13 var raclne:Object - charge»ent_ 

14 //creation d'un element racine 

15 if (racine. nodeName "message 

16 // test s'il s'agit bien d' 

17 liste_txt.text +- racine. at 

18 //construction du message 

19 llste_txt. scroll ■ liste_tx 

20 // gest ion du scroll 

EB 

22 ); 

23 // — — — — — — — — Cest lonnaire 

24 monCtojet_xrril30CKet.onClose - functl 

25 erreur ~ "La connexion a ete in 

26 gotoAndStop( "Erreur") ; 
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Figure 22-25 

Creation de l'image Identification du document Flash chat.fla 



8. La partie suivante permet de creer l'objet XMLsocket (monObjet_xml socket) qui aura en charge la 
connexion avec le serveur socket puis le chargement des messages. Cette premiere instruction est 
suivie du gestionnaire de chargement des donnees de l'objet XMLsocket. Dans ce gestionnaire 
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est cree un objet XML chargement_xml destine a receptionner les donnees du serveur. Un poin- 
teur r a cine est ensuite cree arm de faciliter la gestion des chemins dans le reste du script. 
Une structure de choix i f permet de s' assurer que le nom de 1' element recupere est bien egal a 
message. Si le test est positif, le nouveau message receptionne s'ajoute au contenu du champ 
liste_txt (liste des messages affiches dans l'ecran Dialogue). La derniere ligne du gestion- 
naire est destinee a assurer la gestion du scroll lorsque le nombre de messages excede la zone 
de texte : 

/ /########################C RE AT 1 0 N OBJET SOCKET XML 
monObjet_xml socket = new XMLSocketO; 
// Creation de 1 'objet XMLsocket 

// Gestionnaire du chargement des donnees du socket 

monObjet_xmlsocket.onData = function(data) { 
var chargement_xml = new XML(data); 
// Creation d'un objet XML pour recuperer les donnees 
var racine:Object = chargement_xml .firstChild; 
// Creation d'un element racine (evite la gestion du Flash-root) 
if (racine.nodeName == "message") { 

// Teste s'il s'agit bien d'un element <message> 
1 iste_txt.text += racine. attributes .pseudo+" : "+racine. attributes. texte+newl ine; 
// Construction du message 
liste_txt. scroll = liste_txt.maxscroll ; 
// Gestion du scroll 



9. A la suite de cette premiere partie, on retrouve deux autres gestionnaires de Fobjet XMLsocket. 
Le premier, onCl ose( ), sera invoque si la connexion est interrompue par le serveur socket. Dans 
ce cas, un message d'erreur sera affecte a la variable erreur et la tete de lecture de F animation 
sera positionnee sur l'image Erreur. Lautre gestionnaire sera invoque lors d'une tentative de 
connexion initiee par la methode connectO. Si la connexion n'est pas possible, le parametre 
succes prend la valeur fal se et un message d'erreur est affecte a la variable erreur. Comme dans 
le cas precedent, la tete de lecture de l'animation est positionnee sur l'image Erreur afin de signa- 
ler le probleme a l'utilisateur : 

// — Gestionnaire d'interruption de connexion declenchee par le serveur 
monObjet_xmlsocket.onClose = functionO { 

erreur = "La connexion a ete interrompue par le serveur "; 

gotoAndStop("Erreur") ; 

// Initialisation de la variable erreur 




}; 

// Gestionnaire de connexion au serveur 

monObjet_xmlsocket.onConnect = function(succes) { 
if ( Isucces) { 



erreur = "Impossible de se connecter au serveur sur le port "+numPort; 

gotoAndStopC'Erreur") ; 

// Initialisation de la variable erreur 



); 
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10. La ligne de code suivante ouvre une connexion entre le serveur socket et l'application Flash. Les 
deux variables adresseServeur (adresse du serveur) et numPort (numero du port en ecoute) defi- 
nissant le parametrage du serveur sont passees en argument. Apres l'appel de cette methode, le 
gestionnaire onConnect( ) presente precedemment est invoque : 

//mmmmmmmmmtmmmoHHExioH serveur socket 

monObjet_xml socket. connect (adresseServeur, numPort) ; 

11. Le dernier script place dans cette image cle permet de gerer la validation du pseudo saisi par 
l'utilisateur. Lorsque le bouton OK est relache, la variable pseudo est initialisee avec le nom saisi 
dans le champ pseudo_txt puis la tete de lecture de Fanimation est positionnee sur Fimage 
Dialogue : 

/ /iHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHttUT REE DU PSEUDO 
boutonl_btn.onRelease = functionO { 
if (pseudo_txt.text != "") { 

_root. pseudo = pseudo_txt.text; 

// Sauvegarde du pseudo 

gotoAndStop( "Di al ogue" ) ; 




stop( ) ; 

12. Placez-vous ensuite sur Fimage Dialogue et saisissez le code ci-dessous (voir figure 22-26). La 
premiere partie permet d' initialiser certains parametres de Fanimation : le nom du pseudo affiche 
en haut de Fecran, la zone d'affichage de la liste des messages et le positionnement du focus dans 
le champ de saisie du message : 

//iHHHHHHHHHHHHHHHHHHHHH INITIALISATION 
pseudo_txt.text = _root. pseudo; 
// Initialisation du pseudo 
1 iste_txt.text="" ; 

// Initialisation de la liste des messages 

Sel ection . set Focus (mess a ge_txt ) ; 

// Initialisation du focus sur le champ de saisie 

13. La seconde partie du code permet de gerer le bouton de soumission d'un message (bouton2_btn). 
Des que celui-ci est relache, un objet XML est cree et son contenu est initialise avec un element 
message. Deux attributs pseudo et texte sont ensuite ajoutes a cet element arm de construire le 
document XML. Une fois le document prepare, la methode send( ) est appelee ann de Fenvoyer 
au serveur socket : 

//miHHHHHHHHHHHHHHHHHHmoi D ' UN MESSAGE 
bouton2_btn.onRelease = functionO { 
if (message_txt.text != "") { 

// Teste si un message est saisi 
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II Construction du message 

var envoi_xml = new XML( "<message/>" ) ; 

// Creation de 1'objet initialisation avec element <message> 
envoi_xml .firstChild. attributes. pseudo = _root. pseudo; 
// Ajout attribut pseudo 

envoi_xml .firstChild.attributes. texte = message_txt.text; 
// Ajout attribut texte 
monObjet_xml socket . send (en voi_xml ) ; 
// Envoi au serveur 
message_txt.text = ""; 

// Initialisation du champ de saisie du message 

Selecti on. set Focus (message_txt) ; 

// Initialisation du focus sur le champ de saisie 

} 

}; 
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1 //unttnuuHntwiwuu nnnunnn mitialisatjJP 

2 pseudo_txt.text ■ _root. pseudo; 

3 //init du pseudo 

4 liste_txt.text-""j 

5 //init de la Usee des messages 

6 Selection. setFocus (message_txt) ; 

7 //init du focus sue le champ de sai 

8 / /uMUUUUUHnnnnuuunnuuMMnuwoi d- un 

9 bouton2_btn.onRelease ■ function!) 



(message_txt.text "") { 

//test si un message est sa 

// Construction 

var envoi_xml - nev ULfOn 
//creation de rob jet init 
envoi_xml.f irstChild.attrib 
//ajout attribut pseudo 
envoi_xwl . £ irstChi Id . attr ib 
//ajout attribut texte 
monCtojet_xmlsocket . send (env 
// on envoie au serveur 
message_txt.text • **"; 
// init du chanp de saisie 
Selection. setFocus (message_ 
//init du focus sur le cham 
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Figure 22-26 

Creation de V image Dialogue du document Flash chat.fla 
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14. Positionnez-vous enfin sur l'image Erreur (voir figure 22-27) et ajoutez l'instruction suivante 
arm d'initialiser le champ texte dynamique erreur_txt avec Fintitule de Ferreur genere par les 
gestionnaires de l'objet XMLsocket (revoir l'etape 9 si necessaire) : 



I 



erreur_txt.text=erreur; 
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Figure 22-27 

Creation de l'image Erreur du document Flash chat.fla 



15. Vous pouvez maintenant enregistrer puis publier votre document Flash et passer a la configuration du 
serveur de socket PHP. 

Le serveur de socket PHP 

Contrairement aux autres applications realisees dans cet ouvrage, l'utilisation d'un serveur socket 
necessite une configuration specifique de votre ordinateur afin de pouvoir demarrer le serveur socket 
en ligne de code. Les etapes de l'installation du serveur socket sur votre poste et de ses amenage- 
ments sont detaillees ci-dessous. 
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1. Creez un nouveau repertoire C: /SITEchat/ (a laracine du lecteur C:). Copiez le fichier du serveur 
socket server_chat.php dans ce repertoire (disponible dans le repertoire /SITEchat/ des ressour- 
ces de l'ouvrage) ou recuperez la derniere version du serveur disponible sur le site Internet de son 
auteur : http: //www. your -socket . com/tutor i aux/chat/ 

2. Ouvrez le fichier du serveur server_chat . php avec Dreamweaver. Dans la premiere ligne de code, 
modifiez Fadresse du serveur (valeur affectee a la variable Saddress) en remplacant la valeur 
actuelle par local host afin que le serveur puisse fonctionner sur votre ordinateur en local (voir 
figure 22-28). Une fois la modification effectuee, enregistrez votre fichier sous le meme nom. 
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/ edresse du setveuc qui hebecge 
done vous aver le deoit de vous aeevic Tf}} 



set_tlae_llalt (0); // pas de Liaite dans le temps 
(sock - socket_ceeate(AF_InrT, S0CK_STREAH, 0); Bt4 Lf. socket 

socket_bind((3ock, (addcess, (pott) oc die ('Could not bind to address'); /// on ecoute sue 
le bon poet 

sockee_listen((sock) ; // on ouvee le socket 



(clients = ArcayO; f/ le tableau de iiste des clients 

(coa_councer • 0; /// un coapteur de connection qui sees de pld (process id) 



12 

jBM // 

14 while (true) { /// on touene en boucle 
IS 
16 
17 



// on peepaee le tableau de ce qu'll y a a ecoutet : 
(toeead-Aecayf) ; 
arcay_push((coeead,(soc)t) ; 

foe <U*0;U<count(f clients) ;$!++)( // pout tous les clients 
aeeay_push((tocead,(cllents[(l] ["SOCKET"]) ; 

t 



(ready - socket_setece(( toeead / (a«null,(a-null / (a-null) ; /// on ecoute sue le tableau 



if (in_aecay((sock, (toeead)) { 

// si 1'evenenent est sue le socket e'eae qu'll y en a un nouveau qui active 
// on l'ajoute a la iiste des clients 
echo("«cive> d'un nouveauvn"); 
(con_countec++; 
(caoC-countKclientsl ; 




Figure 22-28 

Modification de Fadresse du serveur socket dans Dreamweaver 



Modificationdufichierphp.ini : ouvrez un explorateur de fichiers (Wi n + E) et parcourez l'arbo- 
rescence de Wamp 5 jusqu'au repertoire php (C : \wamp\php\). Dans ce repertoire, ouvrez le fichier 
php.ini. Une fois que le fichier php.ini est ouvert dans le Bloc-notes, lancez une recherche avec 
le mot-cle php_sockets. Decommentez alors la ligne extension=php_sockets.dll en supprimant 
le point-virgule place en debut de ligne afin d'activer 1' extension php_sockets (voir figure 22-29). 
Enregistrez ensuite le fichier dans le meme repertoire. 
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Modifier le bon fichier php.ini 

Pour activer I'extension php„sockets, vous pourriez etre tente d'utiliser I'option php extension du manager de 
Wamp5ouencoredemodifierlefichierphp.ini a I'aide de I'option config filespuisphp.ini de ce meme 
manager. Cependant, ces deux actions ont une incidence sur le fichier php.ini qui se trouve dans le repertoire 
d'apache et non celui du repertoire /php/. Or, contrairement aux scripts que nous avons developpe jusqu'a 
present, nous utilisons le php.exe qui se trouve dans le repertoire /php/ pour faire fonctionner notre chat. II faut 
done que le php . ini du meme repertoire soit modifie en consequence au risque d'avoir un message d'alerte qui 
vous indiquerait que I'extension php_socket n'est pas activee lorsque vous lancerez le serveur depuis la fenetre 
du terminal. 
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Figure 22-29 

Ouverture du fichier php.ini dans le repertoire /wamp/php/ 



4. Configuration d'une variable d'environnement pour Windows afin de pouvoir demarrer PHP en 
ligne de code : Cliquez sur le bouton Demarrer de Windows, selectionnez le Panneau de configu- 
ration et l'icone Systeme. Cliquez sur l'onglet Avance de la boite de dialogue puis sur le bouton 
Variable d'environnement. Dans la partie du bas, selectionnez la ligne champ Path et cliquez sur 
le bouton Modifier. A la fin du champ Valeur de la variable, ajoutez un point-virgule comme 
separateur, suivi du chemin suivant : C:\wamp\php\; puis validez successivement toutes les boites 
de dialogue ouvertes (voir figure 22-31). 
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I php.int Bloc notes 


EM 


X 


FKhier f.d**on Format AFfKhage I 


; exten5ion-php_ni5 5ql . dll 

; ext ens 1 on-phpjnsql . dl 1 

ext ens 1 on-php jnysql . dl 1 

ext ens 1 on-php_rnysql l.dll ^ 

; extension-php_oci8. dll ^^"^ 

; extens 1on-php_openssl 

; extension-php.ora^ie-rTn 1 

; extenslon-phDj^effTdll 

; extens1oj>j | * 1 P-P9 S( lT - dll 

; exiep*+t5n-php_shmop. dll 

; j^ons1on-php_snnip. dl 1 


^.supprimer le point virgule 
devant la ligne : 

extension = php_sockets.dll 




en" on = phplsybiv s ie3ct . d 1 1 
; extens1on-php_tidy. dll 
; ext ens 1 on»php_xml rpc. dl 1 
; extension-php_xsl.dll 
; ext ens 1 on-php_zi p. dl 1 
extension-php_pdo. dll 
extens1on«php_pdo_sql1te. dll 
; extension-php_pdo_firebird. dll 







Figure 22-30 

Modification du fichierphp.ini (suite) 



t Pdnnedu de configuration Proprtetes sysleme ^^^^^^^^ ? X 
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Variables d'environncmenl 



Variables ubisateur pour Defiance 



Variable 

TEMP 

IMP 



Variable 




TEMP 


C:\Oocument5 end Setttnoj\DerVance\L... 


TMP 


C:\Oecuments and Settir^Defrancey.... 



Variables systeme 



Variable 


Vak» 5 




Windows NT 


Path 


C:\WINOOWSVsyrtern32iC:\VWNOOWS;... . 


proceISStttt 


.COM; .EXE; -BAT; .CMO; .VBS; .V6EJ5-^ 




Restauation du systeme Mis« a iou automatiques Ut*f^rTa disiance > 
General Nom de roronateu Mattnet fl Awe* 



Vous devez avwt ouveit une session en (ant qu'edrnrvstialeui afin tfetl 
Is ptupart de ces frocMicabons 



Lei eflets vtjuers. la plarilicabon du ptoceneu. rutfeabon memcwe el 
la memoire wluele 




| Patamettes 



Prof i des utitateurs 

Peramettes du Bureau kes a voire ouverture de setaon 



Dematrage et recuperation 

Inf ormatLons demanage du tytteme, de defaiance du systeme et de 



Rapport d'erreuM ! 



Figure 22-31 

Configuration de la variable d'environnement Windows 
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5. Demarrez le serveur socket PHP (Wamp n'est pas necessaire car le serveur socket fonctionne 
d'une maniere autonome sur votre poste local) : Ouvrez une fenetre de Terminal (Cliquez sur le 
bouton Demarrer de Windows puis selectionnez Executer et saisissez cmd dans le champ de la 
fenetre). Saisissez ensuite la ligne de commande suivante apres Finvite (voir figure 22-32) puis 
validez en appuyant sur la touche Entree (Attention ! n'oubliez pas de saisir php devant le chemin 
menant au fichier a executer) : 

>php C:\SITEchat\server_chat.php 




Figure 22-32 

Demurrage du 
serveur socket a 
partir d'une 
fenetre de 
Terminal 



6. Votre serveur est demarre (le curseur doit clignoter au debut de la ligne suivante). Si vous desirez 
l'arreter, il vous suffit d'utiliser la combinaison de touches Ctrl + C. 

7. Pour tester le fonctionnement en local du chat, il suffit d'ouvrir plusieurs fenetres de navigateur 
en meme temps pour simuler la presence de differents utilisateurs. Ouvrez un premier navigateur 
et cliquez sur Fichier>Ouvrir (ou Ctrl + 0) et selectionnez le fichier chat.html a l'adresse locale 
C:\SITEchat\chat.html. Dans le champ texte de la page d'accueil de l'animation, saisissez le 
nom du premier utilisateur (par exemple « Jean ») puis validez votre choix. Dans Finterface de dialo- 
gue, saisissez un premier message dans le formulaire du bas puis validez. Votre message doit appa- 
raitre dans la zone de dialogue d'utilisateur de ce meme ecran precede du nom que vous avez choisi. 



Figure 22-33 

Test du serveur 
socket en local 



feE3 



F*Tm • v. . V, •...)» 



Dialogue en ligne 



■■. :iirr p-.n.i]o Jean 



Jean : ftonjour A tous i 
Paul : Satut Jean 

Jean : Cn ma Paul, quel temps tnt-4 a Pan* > 

Paul Un oeu fra-s m*s nous avons un beau eel Bleu 

Paul El w» a Marsetfe quel temp* a* -tu ) 

Man : II pteut A 



1 jwamdat-awl 



FtNw ttbOft AmctMOt Fsvtra OU* ' 



Dialogue en ligne 

.-.tw-^ :■■ Paul 



lean : Bon jour a tous ' 
Paul Sa4ut Jean 

lean : On mo< Paul, que) temps 'art-<i a Pans ' 
Paul : Un peu frart m*s nous avons un beau oel Bleu 
Paul : Et toi a Marseille que! temps as-tu J 
lean : n pteut H 
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Ouvrez maintenant un second navigateur de la meme maniere et saisissez un autre nom (par 
exemple « Paul »). Depuis 1' interface du second utilisateur, saisissez un nouveau message et vali- 
dez-le. Si votre nouveau message est visible de la meme maniere dans les deux navigateurs, le 
systeme de dialogue en direct fonctionne correctement en local (voir figure 22-33). Si vous desi- 
rez mettre en ceuvre cette application de chat en ligne pour connecter differents utilisateurs 
distants, vous devez disposer d'un serveur dont le port d'ecoute est active (pour plus de detail sur 
la disponibilite de ce type d'hebergement ou pour tester d'autres exemples d' application du 
serveur socket, consultez le site de Fauteur du serveur socket PHP utilise dans cette 
demonstration : www.your-socket.com). 



Codes sources disponibles en ligne 

Tous les codes sources des applications presentees dans cet ouvrage sont disponibles sur Internet : 
www. editions -eyrol 1 es . com (mots cles : Fl ash PHP). 
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Conseils pour bien programmer 

Pour bien programmer et creer des scripts performants, quelques regies doivent etre respectees. 

Utilisez I'indentation 

L'indentation correspond a la mise en forme des blocs de code grace a des tabulations differentes 
selon le niveau d' imbrication des structures de boucle ou de choix dans lesquels ils se trouvent. 
Cela met en valeur le debut et la fin des boucles et evite notamment d'oublier des accolades de fin ou 
de debut. 

Avec Dreamweaver, vous pouvez decaler facilement le code a partir du menu Edition>Code de retrait 
(ou encore plus facilement avec la touche Tabulation). Toutes les nouvelles lignes seront decalees du 
meme espace (voir figure 23-1). Pour revenir d'un pas de decalage a gauche, utilisez Foption Deca- 
lage negatif du menu Edition (ou utilisez la touche Backspace). 



Commentez votre code 

Qu'il soit maintenu par le programmeur lui-meme ou par une tierce personne, un programme doit 
toujours etre parfaitement commente (vous me remercierez peut-etre dans quelques mois, lorsque 
vous devrez modifier votre propre code...). Les commentaires d'un programme doivent porter sur 
des informations liees au contexte de F application et non rappeler toutes les descriptions des fonc- 
tions issues du manuel PHP. 
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r esult atdumois . php 



^Code [^FracBonner ^ Creation Jf T*re : Document sans titre 

ijI^BQ ^ cto p, I n o 



<>1 itft ci. 



■:?phl> > 
| 3esslon_3tart( ) ; 

INIT I'ES VARIABLES 

I It (!isset(SHTTP_Grr_VAES[ ' logout ' ]) ) MnTP_GET_VARSC 'loflout' ]""no";//init dc logout si non declare 
l£( 'l33et«HTTP_SESSI0H_VARS[ 'VARlog' ]) ) ShTTP_SE33I0N_VAR3[ 'VARlog' ]-"inconnu";//mit de login 51 non 



I It (CHTTP_GET_VARS[ 'logout' ]«"ok") 
( 

session_destroy( ) ; 
header ("Location: . . /login. php") ; 

) 

lit (smTP_3ESSI0M_VARS['VARstatut'] "com") 



( 



header ("Location: . . /login. php") ; 



Figure 23-1 

Si vous commentez vos scripts et utilisez V indentation de vos blocs de code pour mettre en evidence leur structure, 
voire programme devient beaucoup plus simple d lire et plus facile a depanner. 



Exemple 

Un programmeur se moque de savoir que I'instruction $a++ incremente la variable $a d'une unite ; en revanche, il 
apprecie d'etre informe sur I'utilisation de ce compteur dans le contexte du programme. 



Les commentaires permettent aussi de preciser les liens qui existent entre plusieurs elements d'un code. 



Exemple 

Une solution astucieuse consiste a commenter chaque accolade de fin de bloc avec un rappel de la condition de 
choix ou de boucle qui lui a donne naissance. 



Avec Dreamweaver, vous pouvez utiliser la syntaxe traditionnelle des commentaires PHP s'ils sont 
integres dans une zone de code PHP, soit // pour commenter une simple ligne ou /* et */ pour un 
commentaire sur plusieurs lignes. 

En dehors des balises PHP, utilisez la syntaxe des commentaires HTML, a savoir les balises <!- - et -->. 



Nommez les variables et les fichiers 

Le choix du nom d'une variable est important. Des qu'une variable concerne un element fonctionnel 
du programme, nommez-la avec un nom explicite en rapport avec sa fonction. Vous pouvez concate- 
ner une courte phrase qui caracterise la variable en ne conservant en majuscule que la premiere lettre 
de chaque mot (exemple : prix du produit deviendrait SprixProduit). En revanche, les variables 
d'utilisation ponctuelle, comme les compteurs de boucle ou les variables de fonction, peuvent 
conserver des appellations courtes et generiques ($i par exemple). 
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Pour les noms des flchiers, elaborez une convention de nommage arm de deflnir un prefixe commun 
pour tous les flchiers qui realisent une action d'une meme fonctionnalite (exemple : tous les flchiers 
assurant la gestion du caddie). Cela permet d'identifier les flchiers, mais aussi de les regrouper faci- 
lement par fonctionnalite dans l'arborescence d'un repertoire a l'aide d'un simple tri alphabetique 
(par exemple : caddie_modif.php et caddie_supp.php). 

Utilisez les fonctions 

Si vous decoupez votre code en parties reutilisables, vous pouvez creer des fonctions faciles a exploi- 
ter dans toutes les pages du site. En outre, le code du script principal est plus leger et bien plus lisible. 
Rassemblez ces parties reutilisables dans un fichier commun que vous pourrez appeler au debut de 
chaque page grace a la commande requi re( ). 

Utilisez les fragments de code 

Pour etre encore plus efflcace dans le developpement de vos applications et gagner en productivite, 
utilisez les fragments de code de Dreamweaver. Cela vous evitera de ressaisir a chaque developpe- 
ment des parties de code frequemment utilisees. Par defaut, Dreamweaver est livre avec de nombreux 
fragments de code standards classes par theme que vous trouverez dans le panneau Code/Fragments 
de code. Cependant, la version standard comporte peu de fragments PHP. II vous faudra developper 
vos propres fragments avant de pouvoir les integrer dans vos pages dynamiques. Vous pouvez aussi 
importer des groupes de fragments de code afin de disposer rapidement d'un ensemble de ressources 
creees par des developpeurs chevronnes. Le site www.phpmx.com propose de nombreux fragments que 
vous pourrez facilement ajouter dans votre editeur Dreamweaver. 

Construisez brique par brique 

De meme qu'un macon construit une maison brique par brique sur des fondations solides, le 
programmeur doit commencer par bien analyser le projet dans son ensemble pour deflnir sa structure 
et elaborer des modules correspondant a chaque fonctionnalite. Realisez des essais pour chacun des 
modules des qu'ils sont operationnels et n'attendez surtout pas que tout le site soit cree pour les 
passer au banc. 

Les erreurs PHP 

Syntaxe d'un message d'erreur PHP 

Avant d'etre envoyee vers le navigateur, la syntaxe des scripts PHP est d'abord analysee puis execu- 
tee. Lors de ces deux etapes peuvent apparaitre des erreurs de syntaxe ou de semantique. Des erreurs 
liees a la conception de votre programme (erreur logique) ou au contexte dans lequel il s'execute 
(erreur d'environnement) peuvent egalement se produire. Selon le type d'erreur, des messages diffe- 
rents sont envoyes par PHP et s'affichent dans votre navigateur. Dans un premier temps, il est impor- 
tant de bien analyser ces messages d'erreur. Pour ce faire, il faut connaitre la syntaxe du message 
d'erreur et les differents types d'erreurs qui peuvent se produire. 
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Tableau 23-1. Syntaxe d'un message d'erreur 




Niveau_erreur 


message_erreur in nom_fichier on line num_ligne 





Legende Niveau_erreur : les niveaux d'erreur peuvent etre : 

- Parse_error : erreur de syntaxe lors de ['analyse ; 

- Fatal_error : erreur qui arrete le script ; 

- Warning : erreur qui se contente d'afficher un avertissement mais qui permet de poursuivre le script. 
message_erreur : message correspondant a I'erreur rencontree (les messages sont souvent identiques au 
niveau). 

nom_f ichier : nom du fichier dans lequel I'erreur a ete detectee. 
num_l i gne : numero de la ligne oil se trouve theoriquement I'erreur. 

Voici un exemple d'erreur : 

//ligne de script qui a produit I'erreur (point-virgule oublie en bout de ligne) 
echo "bonjour" 

//La version corrigee serait : echo "bonjour" ; 
//Message d'erreur affiche dans le navigateur : 

Parse error: parse error, unexpected T_VARIABLE, expecting ',' or ';' in 
c:\wamp\www\sitephp\debugphp\erreurl.php on line 4 

Si on analyse I'erreur ci-dessus, on peut en deduire les informations suivantes : 

ni veau_erreur : Parse error ; 

message_erreur : "parse error, unexpected "INVARIABLE, expecting ',' or ';'" ; 
nom_fichier : c:\wamp\www\sitephp\debugphp\erreurl.php ; 
num_ligne : line 4. 

Erreur de syntaxe 

Une erreur de syntaxe se produit lorsque le code est analyse par l'interpreteur PHP. Elle peut etre 
comparee a une faute de grammaire comme « mon ordinate ur sont en marche ». Si la syntaxe du 
langage PHP n'est pas parfaitement respectee, l'analyseur renvoie un message d'erreur. 

Voici un exemple d'erreur de syntaxe : 

$varl=5; 
$var2=3; 

//Ligne de script qui a cause I'erreur 
$var3=(2+$varl)*$var2);// << ici il manque une parenthese 
//La version corrigee serait : $var3=((2+$varl)*$var2); 
//Message d'erreur affiche dans le navigateur 
Parse error: parse error, unexpected ')' in c:\wamp\www\sitephp\ 
debugphp\erreur2.php on line 4 

Si on analyse I'erreur ci-dessus, on peut en deduire les informations suivantes : 

niveau_erreur : Parse error ; 

message_erreur : parse error, unexpected ')' ; 

nom_fichier : c:\wamp\www\sitephp\debugphp\erreur2.php ; 

num_l igne : line 4 . 
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Erreur de semantique 

Si une erreur de syntaxe peut etre comparee a une faute de grammaire, F erreur de semantique se 
rapproche d'une phrase grammaticalement correcte mais n' ay ant aucun sens, par exemple «j'irai 
hier ». La syntaxe etant correcte, aucune erreur de syntaxe n'est opposee par l'analyseur, mais une 
erreur survient lorsque PHP tente d'interpreter le code errone. 

Voici un exemple d' erreur de semantique : 

//Ligne de script qui a genere l'erreur 
defineC'TVA") ; // << ici il manque un argument 
//La version corrigee serait : defineC'TVA", 19. 6); 
//Message d'erreur affiche dans le navigateur 

Warning: Wrong parameter count for defineO in c:\wamp\www\sitephp\ 
Adebugphp\erreur3.php on line 2 

Dans cet exemple, la syntaxe est correcte, mais il manque un argument lors de l'appel a la fonction 
defineO, qui necessite au minimum deux arguments. Si on analyse l'erreur ci-dessus, on peut en 
deduire les informations suivantes : 

niveau_erreur : Warning ; 

message_erreur : Wrong parameter count for defineO ; 
nom_fichier : c:\wamp\www\sitephp\debugphp\erreur3.php ; 
num_ligne : line 2. 

Erreur de logique 

L'erreur de logique est certainement la plus difficile a localiser car, dans la plupart des cas, elle ne 
provoque aucun message d'erreur. Elle pourrait correspondre au comportement d'une personne qui a 
perdu la raison : « Je suis fou et je me comporte en depit de tout bon sens ». Lorsqu'il y a erreur de 
logique, le code est correct au niveau de la syntaxe et de la semantique, mais il ne realise pas ce que 
le programmeur desire ! 

Erreur d'environnement 

Votre programme peut tres bien avoir une syntaxe, une semantique et une logique correctes et fonc- 
tionner normalement dans un contexte donne, mais causer des erreurs dans un autre environnement 
(serveur Web ou de bases de donnees different, acces au reseau different. . .). Dans ce cas, il s'agit d'erreurs 
d'environnement et si 1' environnement ne peut pas etre adapte, il faut mettre en place des scripts 
supplementaires arm de neutraliser chacune de ces erreurs apres identification et analyse des causes. 

Configuration du niveau de rapport d'erreur : 

Le fichier de configuration php.ini contient une option error„reporting qui peut etre parametree 
selon le niveau de controle que vous souhaitez pour vos scripts. Dans les dernieres versions de PHP, 
cette option est configuree par defaut avec la valeur E_ALL qui est le niveau maximal de controle. Avec 
ce parametrage, toutes les variables non declarees provoqueront automatiquement un Warning (Unde- 
fined variable). Si vous desirez eviter ces Warning, assurez-vous que toutes vos variables seront 
toujours initialisees (revoir l'instruction isset( ) dans le tableau 6-13 du chapitre 6). Vous pouvez 
egalement remplacer la valeur actuelle par E„ALL & ~ E_N0TICE ou encore integrer ponctuellement la 
fonction error_reporting(7) ; dans le script de la page concernee. 
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Techniques de debogage 

Les programmes ne fonctionnent pas toujours du premier coup. Pour mettre au point vos program- 
mes, analysez bien les messages d'erreurs et utilisez des techniques de debogage afin de localiser 
rapidement les erreurs dans votre script. 



Utilisez I'equilibrage des accolades 

Le non-respect de I'equilibrage des accolades d'ouverture et de fermeture est frequemment a 
Forigine des erreurs de syntaxe. Utilisez l'equilibreur d'accolades que Dreamweaver met a votre 
disposition pour vous assurer que votre programme respecte bien cette regie. Pour activer I'equili- 
brage d'accolades, placez votre pointeur a droite de la premiere accolade du bloc a tester, puis activez 
le testeur (selectionnez Edition>Equil ibrer les accol ades ou utilisez le raccourci clavier Ctrl + ,). 
Toute la zone correspondant a un bloc equilibre (selon le niveau d' imbrication) est alors automatique- 
ment selectionnee. Si vous renouvelez le test, la zone selectionnee s'etend au niveau d' imbrication 
superieur et ainsi de suite jusqu'au dernier bloc. Un son signale que le test est termine. Verifiez qu'il 
ne reste aucune accolade en dehors de la zone selectionnee. Dans r affirmative, ajoutez l'accolade 
manquante et renouvelez le test (voir figure 23-2). Si le testeur ne peut pas poursuivre sa recherche 
des le debut du test, il emet un son pour vous le signaler. 



|<?php 

£ ($action""ok") 



© 



if ($action=="ok") 



echo "debut de la boucle de test" 
£or(«-5;U>0;U--) 



echo "il reste $i boucle" 



o 



echo "fin de la boucle de test"; 



10 

li 

12 
li 
14 
IS 
16 
1" 
is 



echo "debut de la boucle de test" 
£or(*i-5;«i>0;«i~) 



echo "il reste Si boucle" 



echo "fin de la boucle de test" 



Figure 23-2 

L'equilibreur d'accolades de Dreamweaver permet de localiser rapidement un desequilibre entre le nombre 
d'accolades d'ouverture et de fermeture pour une zone de programme defini. A gauche, l'equilibreur emet un son pour 
signaler un desequilibre car il reste un nombre impair d'accolades en dehors de la selection. A droite, le test est 
concluant. 



Detectez les erreurs de logique 

Les erreurs de syntaxe ou de semantique sont toujours accompagnees d'un message d'erreur qui 
precise le fichier et la ligne ou se trouve l'erreur : il suffit en general de revoir le code situe a ce niveau 
pour resoudre le probleme. En ce qui concerne les erreurs de logique, il est parfois difficile de locali- 
ser les lignes de code qui sont a l'origine du mauvais fonctionnement. Dans ce cas, le moyen le plus 
simple consiste a commenter les lignes (utilisez //) ou les blocs de code (utilisez /* et */) suscepti- 
bles de provoquer l'erreur et a tester de nouveau le programme. Ainsi, par recoupements, vous 
pouvez circonscrire l'erreur de maniere precise. 
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La fonction phpinfoQ 

La fonction phpinfo( )affiche tous les parametres de la configuration de PHP. Pour creer une page 
d'affichage de ces parametres, saisissez cette fonction dans une page PHP (qui serait nommee 
phpinfo.php, par exemple), comme indique ci-dessous, et appelez-la depuis le Web local ou depuis 
votre serveur distant. Vous pouvez egalement l'ajouter en bas de vos pages en cours de test, afin 
d'afficher les differentes variables actives et connaitre leur valeur. 

Voici le code a saisir dans le fichier phpinfo.php pour afficher la configuration de PHP : 

<?php 
phpinfo( ) ; 
?> 

Outre tous les parametres PHP, qui peuvent s'averer tres utiles pour connaitre la configuration de 
votre serveur, la fonction phpinfo( ) affiche toutes les valeurs des variables creees avec des requetes 
GET ou POST ainsi que le contenu des cookies. Dans l'exemple de la figure 23-3, nous appelons le 
fichier phpinfo.php en passant deux parametres dans FURL (varl et var2). Nous les retrouvons dans 
le tableau Vari abl es (en bas de la page phpi nf o) accompagnees de leur valeur respective. 
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Figure 23-3 

L 'integration de la fonction phpinfo( ) dans une page a tester permet d'afficher de nombreuses informations sur 
I'etat des valeurs actives dans la page (GET, POST, cookies...). 
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Les pieges 

L'examen des valeurs affectees a certaines variables pour differents endroits du script est souvent 
necessaire au depannage. Pour ce faire, vous pouvez ajouter dans votre page a tester des pieges qui 
affichent les noms des variables a tester suivis de leur valeur. Vous pourriez evidemment vous conten- 
ter d'ajouter dans votre code une simple fonction echo $varl ; mais si vous desirez tester plusieurs 
variables dans la meme page, cela devient vite illisible. Nous vous suggerons done d'utiliser le code 
ci-dessous, qui presente l'avantage de rappeler le nom de la variable et d' inserer automatiquement un 
retour a la ligne apres chaque test. Apres son utilisation, vous pourrez localiser rapidement tous les 
endroits ou vous avez insere un piege. L'astuce consiste a lancer une recherche sur le mot PIEGE et a 
commenter la ligne ou a la supprimer completement si tous les problemes sont resolus. 

echo '$varl=' .$varl. '<br>' ; // PIEGE valeur 

Dans certains cas, Ferreur peut provenir du type de la variable traitee. Pour tester cette information dans 
le programme, ajoutez Faffichage de son type, avec la fonction gettype() a la suite du piege precedent : 

echo '$varl=' .$varl. ' de type ' .gettype($varl) . ' <br>'; //-PIEGE type 

Enfin, pour depanner les scripts utilisant des variables de type tableau, employez la fonction 
print_r( ) que nous avons presentee lors de 1' etude des tableaux dans le chapitre 6 : 

print_r($tabl) ; // PIEGE tableau 

Les fonctions de debogage 

Une solution plus elaboree consiste a developper une fonction activee lors du debogage arm d'affi- 
cher ou d'enregistrer une trace de Faction realisee. Pour activer ou desactiver cette fonction, vous 
pouvez la passer dans FURL en lui affectant la valeur 1 pour activer le debogage (exemple : 
mapage.php?modedebug=l). Vous pouvez ajouter localement cette fonction au code de la page, mais il 
est plus judicieux de Fintegrer dans un fichier de fonctions appele par une commande requireO. 
Vous trouverez ci-dessous un exemple de fonctions que vous pouvez utiliser lors de la mise au point 
de vos programmes en local : 



if( !isset($_GET['modedebug'])) $_GET['modedebug']=0; 
else $modedebug=$_GET[ 'modedebug ' ] ; 
//Fonction de debogage a inserer dans la page testee 
function debugphp($varl) 
{ 

if($GLOBALS["modedebug"]==l) 

echo 'PIEGE:$varl=' .$varl. ' de type ' .gettype($varl) . ' <br>'; 
} 

//Affectation d'une variable pour les besoins de 1 'exemple 
$var2="bonjour" ; 

//Insertion du piege pour tester la variable $var2 

debugphp($var2) ; 

?> 




<?php 

//Fonction de debogage a inserer dans la page testee 



// 



initialisation des variables 
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Si vous testez l'exemple ci-dessus en passant un parametre dans l'URL pour indiquer que vous desi- 
rez afflcher le piege, (exemple : mapage.php?modedebug=l), votre navigateur doit afficher le texte du 
piege ci-dessous : 

PIEGE : $varl=bonjour de type string 



Attention ! 

Si la variable que vous desirez tester n'est pas initialisee, des messages d'erreur Undefined variable peuvent 
apparaitre a I'ecran selon la configuration de votre serveur. Pour eviter cela, ajoutez la ligne de code suivante avant 
votre piege. Lasyntaxe $varl est valable pour une variable interne, maiss'il s'agitd'une variable issue d'un formu- 
laire, d'une session, d'un cookie ou encore passee dans l'URL, utilisez le tableau de variable adapte 
($_XXX_VARS['varl']) : 

If( ! isset($varl) ) $varl= "variable non declaree"; 



Suppression des messages d'erreur 

Si lors du developpement, tous les messages doivent etre affiches afin de mettre au point le 
programme, en production il est preferable que ces messages ne soient pas affiches dans la page Web 
visible par tous les internautes. Vous pouvez neutraliser l'apparition de ces messages a I'ecran en 
ajoutant un @ devant la fonction concernee. Considerez cette methode comme une solution de depan- 
nage en attendant de trouver la cause du probleme ou pour empecher Faffichage d'un simple warni ng 
qui n'a pas d' incidence sur le fonctionnement du script de la page. 

Dans cet exemple, nous allons creer une erreur de division par 0 : 

$varl=0;//simulation d'une erreur d'affectation pour les besoins du test 
echo " Sans @ <br>" ; 

$testerreur= (5/$varl) ;//Un message de Warning signalera la division par 0 
echo " Avec @ <br>" ; 

$testerreur=@(5/$varl) ;//Ici il n'y aura pas de message d'erreur 
echo " Fin du test <br>"; 

Si vous testez ce code dans votre navigateur, il affiche les lignes suivantes : 

Sans @ 

Warning: Division by zero in c:\wamp\www\sitephp\debugphp\debug2.php Aon line 4 

Avec @ 

Fin du test 



Testez vos requites SQL dans phpMyAdmin 

Si vous developpez des pages integrant des requetes SQL, il est possible que 1' erreur provienne d'un 
resultat errone ou manquant remonte par la base, voire d'une erreur de syntaxe dans la requete SQL. 
Pour eviter ce genre de probleme, testez la requete utilisee avant de l'integrer dans le script PHP de 
la page dynamique. Pour tester une requete, il suffit de la copier dans la zone Executer une requete 
du gestionnaire phpMyAdmin et de cliquer sur le bouton Executer. Le resultat de la requete doit alors 
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s'afficher (voir figure 23-4). Si une erreur est signalee ou si le resultat ne correspond pas a vos atten- 
tes, corrigez la requete avant de la copier et de la tester dans la page dynamique. 



3 locdlhost / localhost /sporl db | phpMyAdmin 2.7.0 pl1 Microsoft Internet Exploi 
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Figure 23-4 

Avant d'integrer votre requete SQL dans un script PHP, testez-la au prealable a Vaide de phpMyAdmin. 
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Conseils pour bien programmer 

Comme les scripts PHP, la creation d'un programme en ActionScript necessite de respecter quelques 
regies. 

Utilisez I'indentation 

Un programme AS est souvent constitue de plusieurs blocs de code imbriques. Structurez-le a l'aide 
de tabulations afin de mettre en evidence la hierarchie des differents blocs. 



Figure 24-1 

he bouton Format automatique de Vediteur 
de script permet d' appliquer I'indentation 
ideale au script affiche dans la fenetre de 
Vediteur. 
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I message_txt.text = racinefirstCrnld.nodeValue; 
| > else { 

I //si pas d'erreur. affiche le nbre de resulats 
| message_txt.text « *!i v a "+nbSlgnet♦• resultat(s)"; 



V ------ - — Gestion du Resuttat 
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I resuttat = m ', 
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Avec 1' interface auteur de Flash, utilisez une fonction specifique disponible depuis un bouton de 
Fediteur de script. Ce bouton, nomme Format automatique (voir figure 24-1), permet de formater 
automatiquement les lignes de code en appliquant l'indentation ideale pour mettre en evidence la 
structure du script affiche dans Fediteur. 

Commentez votre code 

Un programme AS doit etre commente : cela ameliore sa lisibilite et facilite sa maintenance. Comme 
en PHP, les commentaires peuvent egalement preciser les liens qui existent entre plusieurs elements 
du code. Par exemple, pour les accolades de bloc, une solution astucieuse consiste a commenter 
chaque accolade de fin de bloc avec un rappel de la condition de choix ou de boucle qui lui a donne 
naissance. 

Avec Flash, vous pouvez utiliser deux types de syntaxe pour inserer des commentaires. La premiere 
consiste a ajouter deux slash (// ) au debut d'une ligne pour la convertir en commentaire. La seconde 
consiste a inserer un slash suivi d'une etoile (/*) au debut d'un ensemble de lignes a convertir en 
commentaire et une etoile suivie d'un slash pour marquer la fin de cet ensemble (*/). 



A noter 

Les commentaires sont frequemment utilises pour neutraliser une ligne de code ou un bloc de script en phase de 
debogage. 



Nommez les variables et les fichiers 

Comme en PHP, il est important de definir une convention de nommage et de la respecter scrupu- 
leusement. Par exemple, vous pouvez convenir de definir vos noms de variables de fonctions ou 
d'objets par concatenation des mots decrivant leur signification. Dans ce cas, la premiere lettre du 
second mot concatene (ou des mots suivants) sera toujours en majuscule afin de mettre en 
evidence la concatenation effectuee et d'augmenter la lisibilite (exemple : prix du produit devien- 
drait prixProduit). En revanche, les variables d' utilisation ponctuelle, comme les compteurs de 
boucle ou des variables de fonction, peuvent conserver des appellations courtes et generiques (i par 
exemple). 

Flash est sensible a la casse et il faut la respecter dans le nommage puis dans 1' utilisation des noms 
de variables, des fonctions et des objets utilises en AS (le nom de variable prixProduit est different 
de PrixProduit). 



Utilisez les fonctions 

Si vous decoupez votre code en parties reutilisables, vous pouvez creer des fonctions faciles a exploi- 
ter dans un meme scenario, voire dans tout le document si les fonctions sont declarees comme des 
fonctions globales. En outre, le code du script principal est plus leger et bien plus lisible. 
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Centralisez votre code dans une meme image cle 

Les methodes de gestionnaire d'evenements (revoir le tableau 7-45 si necessaire) permettent de 
centraliser tous les scripts definissant le comportement des elements de F animation pour un evene- 
ment specifique dans un seul et meme endroit : le panneau Action d'une image cle. 

Cela vous evite de rechercher les scripts associes a un element sur la scene pour le modifier et vous 
disposerez d'une vue d' ensemble des differents scripts, ce qui facilite la mise au point et la mainte- 
nance de F application. 

Structurez votre projet 

Avant de passer a la creation de vos programmes, etablissez un cahier des charges precis de votre 
projet. Pour cela, commencez par analyser le projet dans son ensemble pour definir sa structure et 
elaborer des modules correspondant a chaque fonctionnalite. 

Lors de la phase de developpement, vous devrez realiser des essais individuels pour chacun des 
modules des qu'ils sont operationnels. N'attendez pas que l'application soit entierement terminee 
pour passer dans l'environnement de test de Flash. 



Les erreurs ActionScript 

Comme en PHP, dans un programme ActionScript, differents types d' erreurs peuvent 
apparaitre : erreurs de syntaxe (liees au respect de la syntaxe du code), erreurs de semantique 
(liees au bon usage des fonctions ou methodes), erreurs de logique (liees a la conception de 
votre programme) ou encore erreurs d'environnement (liees au plug-in du poste client sur lequel sera 
executee l'application). Selon le type d'erreur, il est plus ou moins difficile d'identifier l'origine du 
probleme. 

Erreur de syntaxe 

Une erreur de syntaxe est signalee lorsque le code est compile. La compilation d'un document Flash 
est effectuee lors de l'exportation du document FLA au format SWF avant sa mise en production ou 
des que vous passez dans l'environnement de test de Flash. Le compilateur de Flash analyse toutes 
les lignes du code de votre application. Si une erreur est detectee, un message d'erreur est affiche 
dans le panneau Sortie. 

Connaitre la composition de ce message permet de localiser rapidement l'origine du probleme. Un 
message d'erreur indique le nom de la sequence, le nom du caique, le numero de F image et le 
numero de la ligne dans laquelle se trouve F erreur ainsi qu'une courte description de la nature de 
celle-ci. 
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Tableau 24-1. Syntaxe d'un message d'erreur de compilation 



Syntaxe 




Exemple 



**Erreur** 



**Erreur** 



Sequence = Sequence x, 
caique = nomCalque, 



Sequence = Sequence 1, 
caique = Action, 
image = 1 
:Ligne 1 



image = x 



: Ligne x 



Nature de 1 'erreur 



: Norn de parametre attendu 
boutonl_btn.onRelease=function ( { 



extrait du code errone 



Total des erreurs 



Total des erreurs 



ActionScript : x 
Erreurs signalees : x 



ActionScript : 1 
Erreurs signalees : 1 



Nous avons volontairement realise une erreur dans le code d'une animation de copie de texte (oubli 
de la parenthese fermante de function). Lors de sa publication, un message d'erreur s'affiche auto- 
matiquement dans le panneau Sortie (voir figure 24-2). L' analyse de ce message permet de localiser 
facilement l'endroit ou se trouve Ferreur de syntaxe : 

boutonl_btn.onRelease=function ( {//<< ici il manque une parenthese 
affichage_txt.text="COPIE : "+message_txt.text 
//Tracet "copie effectuee"); 
} 

Message affiche dans le panneau Sortie lors de la compilation : 

**Erreur** Sequence = Sequence 1, caique = Action, image = 1 : Ligne 1 : Norn de parametre attendu 

boutonl_btn .onRel ease=function ( { 
Total des erreurs ActionScript : 1 Erreurs signalees : 1 

Si on analyse Ferreur ci-dessus, on peut en deduire les informations suivantes : 

• numero de la sequence : 1 ; 

• nom du caique : Action ; 

• numero de F image : 1 ; 

• numero de la ligne : 1 ; 

• nature de Ferreur : Nom de parametre attendu ; 

• extrait du code errone : boutonl_btn.onRel ease=f unction ( { ; 

• nombre d' erreurs : 1. 
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7 Macromedia Flash Professional 8 - [copie.fla*] 
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Figure 24-2 

Simulation d'une erreur dans le code de Vimage 1 (la parenthese fermante de function manque). 

Lors de la compilation, un message signalant V erreur s'affiche automatiquement dans le panneau Sortie. 



Le bouton Verifier la syntaxe 

Lorsque vous compilez votre application, toutes les sequences, tous les scenarios et toutes les images 
sont analyses en meme temps. En consequence, si vous deboguez des applications importantes, 
le nombre d'erreurs affichees dans le panneau Sortie peut etre consequent et leur interpretation 
difficile. Dans ce cas, testez chaque partie de code isolement en utilisant le bouton Verifier la 
syntaxe de l'editeur de script. Cette methode evite de lancer de longues compilations et permet 
de gagner du temps (le temps de compilation d'une animation est souvent proportionnel a 
sa faille). D' autre part, cette methode permet de localiser un probleme dans une application impor- 
tante. 
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Figure 24-3 

Simulation d'une erreur dans le code de Vintage 1 (la parenthese fermante de function manque). Nous axons utilise le 
bouton Verifier la syntaxe de I'editeur de script. 



Erreur de semantique 

Meme si la syntaxe de votre script est correcte, des erreurs de semantique peuvent entrainer des 
dysfonctionnements. Ces erreurs sont en general plus delicates a localiser car les problemes apparais- 
sent pendant 1' execution de F application et aucun message d' erreur n'apparait dans le panneau 
Sortie lors de la compilation. La solution consiste a inserer des instructions trace( ) judicieusement 
placees ou a utiliser le debogueur (voir figure 24-4). 
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Figure 24-4 

Simulation d'une erreur dans le code de V image 1 (le nom du champ texte message _txt est errone). Ce type d' erreur ne 
renvoie pas de message d'erreur mais entraine des dysfonctionnements lors du test de I 'application. 



Erreur de logique 

L' erreur de logique est certainement la plus difficile a localiser : dans la plupart des cas, elle ne 
provoque aucun message d'erreur ni dans la phase de compilation ni lors de F execution de l'applica- 
tion. Lorsqu'il y a erreur de logique, le code est correct au niveau de la syntaxe et de la semantique, 
mais il ne realise pas ce que le programmeur desire ! 

Face a ce type d'erreur, la parade consiste a faire appel a l'instruction traceO et au debogueur et a 
proceder a une analyse pertinente des resultats. 
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Erreur d'environnement 

Votre programme peut tres bien avoir une syntaxe, une semantique et une logique correctes et fonc- 
tionner normalement avec une version donnee de plug-in Flash (Flash 5, Flash MX, Flash MX 2004, 
Flash 8...), mais causer des erreurs avec une version anterieure. Dans ce cas, il s'agit d'erreurs 
d'environnement. Pour eviter ce type d' erreur, vous pouvez publier votre application dans diffe- 
rentes versions et les proposer aux utilisateurs de votre application. II est cependant beaucoup plus 
judicieux de mettre en ceuvre un systeme de detection de versions arm d'appeler automatiquement la 
version adaptee a Fenvironnement du poste client ou de lui suggerer de telecharger le plug-in corres- 
pondant. 



Techniques de debogage 

Les programmes ne fonctionnent pas toujours du premier coup. Pour mettre au point vos program- 
mes, vous devez analyser les messages d'erreurs et utiliser des techniques de debogage afin de loca- 
liser rapidement l'erreur dans votre script. 

Commentez le code suspect 

Dans certains cas, notamment pour localiser des erreurs de semantique ou logiques, il peut etre inte- 
ressant de commenter les lignes (utilisez //) ou les blocs de code (utilisez /* et */) susceptibles de 
provoquer l'erreur et de tester de nouveau le programme. Ainsi, par recoupements, vous pouvez 
circonscrire l'erreur de maniere precise. 

L'instruction traceQ 

L'examen des valeurs affectees a certaines variables pour differents endroits du script est souvent 
necessaire au depannage. Pour ce faire, ajoutez dans la page a tester des instructions qui affichent les 
noms des variables a tester suivis de leur valeur. 

Flash dispose d'une instruction dedie a cet usage, trace(), qui permet d'envoyer un texte ou la valeur 
d'une variable dans la fenetre du panneau Sorti e. Bien utilisee, cette technique permet de localiser la 
plupart des erreurs de code. 

Nous avons ajoute trois instructions traceO dans le code de l'exemple precedent. Nous avons 
ensuite teste l'application afin d'afficher les messages correspondants dans le panneau Sortie 
(voir figure 24-5) : 

boutonl_btn.onRelease=function ( ){ 
affichage_txt.text="COPIE : "+message_txt.text 
trace( "copie effectuee"); 

traceCle texte saisi est : "+message_txt.text) ; 
traceCle texte affiche est : "+affichage_txt.text) ; 

} 
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Figure 24-5 

Test d 'une application dans laqitelle out ete ajoutees trois instructions trace( ) 



Debogueur en mode test 

Fonctionnalites du debogueur 

Le debogueur et ses differentes fonctionnalites sont presentes dans le chapitre 3 consacre a F interface 
Flash 8 (revoir figures 3-30 a 3-37). Nous vous invitons a revoir cette partie si necessaire. 

Une autre possibilite, plus elaboree que l'insertion d'instructions traceO, consiste a utiliser le debo- 
gueur de Flash. II permet non seulement de visualiser revolution des valeurs et des proprietes en 
temps reel lors de l'execution d'une animation, mais aussi de les modifier afin de forcer leur affecta- 
tion et de controler leur incidence dans le deroulement de F application. 

D'autre part, un systeme de point d'arret permet de controler l'execution d'un programme ligne apres 
ligne. Vous pourrez ainsi arreter ou redemarrer l'execution d'un script ou encore avancer en pas a pas 
afin d'observer Fincidence de chaque instruction dans Fevolution des variables ou proprietes de 
Fanimation. 
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Pour illustrer l'utilisation du debogueur nous vous proposons de realiser une petite application de 
pendule. 

Le document Flash 

Le document Flash que nous allons utiliser pour vous expliquer l'utilisation du debogueur permet de 
demarrer ou d'arreter la rotation des deux aiguilles de la pendule. Deux clips seront realises pour 
materialiser les aiguilles : petiteAiguil lel_mc et grandeAigui 1 lel_mc. La mise en route de la pendule 
sera assuree par un bouton Marche d'occurrence marchel_btn. L' arret de la pendule sera, quant a lui, 
assure par un bouton Stop d'occurrence stopl_btn (voir figure 24-6). 



6. «. ™ 
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| function arreterf) ( 

trace ( "f ct arreter") ; 
grandeAigui llel_mc. tour neGrande-O; 
pet iteAiguillel roc . tournePetite"0; 
I > 

| function demarrer (a) ( 

trace ( "t ct demarrer") ; 
grandeAigui liel_mc._alpha"a; 
grandeAigui 1 le l_mc . tourneGrande- 1 ; 
pet iteAiguillel_mc. tour nePetiteM; 



I stopl_btn. onRelease-f unction ( ){ 
I trace ("BP STOP ACTIONNE") i 

arreter () ; 

> 

lmarchel_btn.onRelease a funetlon ( ) ( 
trace ( "BP HARCHE ACTIONNE") ; 
demarrer (100) ; 

i 

i // 

I pet iteAiguillel_mc. toucnePetite-O; 

I petlteAiguillel_roc.onEnterFranie ■ function () 

If (this, tour nePet ice" 1) 

this._rocacion+"l; 

| ) 
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Figure 24-6 

Creation de V application de test pendule. fla 



1. Creez un nouveau document Flash et sauvegardez-le sous le nom pendule.fla dans un sous- 
repertoire du dossier www/SITEflash/ de votre serveur local (par exemple, le sous-repertoire II- 
debogage/). 

2. Creez cinq caiques : Action, Aiguille, Pendul e, Bouton et Fond. 
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3. Dans le caique Fond, placez un fond de votre choix et ajoutez un titre (par exemple « La 
pendule »). 

4. Dans le caique Bouton, creez et placez deux boutons d'occurrence marchel„btn et stopl„btn. 

5. Dans le caique Pendul e, creez le tour de la pendule. 

6. Dans le caique Ai gui 1 1 e, creez deux clips pour deux aiguilles de taille differente et d'occurrence 
peti teAi gui 1 1 el_mc et grandeAi gui 1 1 el_mc. 

7. Dans le caique Action, saisissez le code ci-dessous. Ce script est constitue de deux fonctions 
destinees a arreter ou a demarrer la pendule. Elles seront appelees par les gestionnaires des 
boutons Stop et Marche. Enfin, deux gestionnaires onEnterFrame permettent de controler en 
permanence la rotation des aiguilles (voir figure 24-6) : 

function arreterO { 
trace( "f ct arreter" ) ; 
grandeAi gui llel_mc.tourneGrande=0; 
peti teAi gui llel_mc.tournePetite=0; 

} 

function demarrer( ) { 
traceC'fct demarrer"); 
grandeAi gui 1 1 el_mc.tourneGrande=l ; 
peti teAi gui llel_mc.tournePetite=l; 

} 

// 

stopl_btn .onRel ease=function ( ){ 

traceC'BP STOP ACTIONNE" ) ; 

arretert ) ; 

} 

marchel_btn.onRelease=function ( ){ 
traceC'BP MARCHE ACTIONNE" ) ; 
demarrer( ) ; 
} 

// 

peti teAi gui 1 lel_mc.tournePetite=0; 
petiteAiguillel_mc. onEnterFrame = function () { 

if(this.tournePetite==l) 

this._rotation+=l; 

} 

grandeAi gui 1 lel_mc. tourneGrande=0; 

grandeAi gui llel_mc. onEnterFrame = function () { 

i f (this .tourneGrande==l) 

this._rotation+=5; 

} 

8. Enregistrez votre animation avant de passer en mode test. 
Controle avec debogage 

L' application dediee aux tests etant realisee, nous allons la controler avec le debogueur. Pour passer 
en mode test avec debogage, selectionnez Controle dans le menu de l'interface auteur puis l'option 
Deboguer l'animation (ou utilisez les touches Ctrl + Maj + Entree). 
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Le panneau de debogage doit apparaitre dans Fespace de test. Par defaut, l'execution des scripts est 
en mode « pause » arm de permettre a l'utilisateur de mettre en place d'eventuels points d' arrets. 
Appuyez sur la fleche verte pour demarrer l'execution du programme (voir repere 1 de la figure 24-7). 
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1 function arreterf) 1 

2 trace ("fee arreter"); 

3 grandeAiguillel_n.c . tour neGrande-O; 

4 pet iteJUguillel_j«c. tournePet ite"0; 

5 > 

6 function denarrer(a) < 
trace ("ret demarrer") ; 
grandeAiguillel_mc._alpha-a; 
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Figure 24-7 

Modification d'une propriete d'un objet de I 'animation 



Le panneau Proprietes 

Cliquez ensuite sur le clip grandeAi gui 1 1 el_mc dans la liste hierarchique du debogueur puis selection- 
nez Fonglet Proprietes (voir repere 3 de la figure). Vous devez alors avoir acces a toutes les proprietes 
du clip selectionne. Les proprietes de F objet disponibles en lecture/ecriture (en noir) peuvent etre 
directement modifiees depuis ce panneau en double -cliquant sur la valeur correspondante. Les autres 
proprietes (en bleu) sont disponibles uniquement en lecture et ne peuvent done pas etre modifiees. 
Double-cliquez sur la valeur de l'alpha et saisissez la valeur 50 au lieu de 100. Des que la nouvelle 
valeur est saisie, l'alpha de la grande aiguille est reduit a 50 %. 
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Le panneau Proprietes permet de controler toutes les proprietes modifiables de Fanimation. Vous 
pourrez ainsi forcer certaines proprietes d'un objet et apprecier Fincidence de votre action dans 
1' animation en temps reel. 

Le panneau Variables 

Cliquez ensuite sur Fonglet Variables (voir repere 1 de la figure 24-8). Vous disposez maintenant 
d'un tableau representant les differentes variables du scenario selectionne (dans notre exemple, il 
s'agit du scenario du clip grandAiguillel_mc). De la meme maniere que vous avez precedemment 
modifie la valeur de la propriete de 1' alpha, vous pouvez agir sur la valeur de ces variables. Double- 
cliquez sur la variable tourneGrande (voir repere 2 de la figure 24-8) et saisissez la valeur 1 a la place 
du 0 initial. Des que la valeur est saisie, la grande aiguille de la pendule commence a toumer (voir 
repere 3 de la figure 24-8). 
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Figure 24-8 

Modification de la variable d'un scenario de V animation 
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Le panneau Observateur 

Ce que nous venons de faire pour la grande aiguille est applicable a la petite aiguille de la pendule et 
a tous les clips d'une animation. II suffit de selectionner le clip desire dans la liste hierarchique pour 
disposer de ses variables de scenario dans le panneau Van' abl es. Cependant, il est souvent interessant 
de surveiller ou modifier plusieurs variables se trouvant dans des scenarios differents. Le debogueur 
dispose d'un panneau Observateur qui permet de regrouper differentes variables de scenarios diffe- 
rents dans un seul et meme panneau, ce qui evite de passer d'un clip a Fautre pour suivre revolution 
de leurs variables. Pour ajouter une variable au panneau Observateur, cliquez droit sur son nom dans 
le panneau Variables et selectionnez l'option Observateur. 

Nous vous proposons d'ajouter les deux variables grandeAi gui 1 1 e et peti teAi gui 1 1 e dans le panneau 
Observateur afin de controler le fonctionnement des deux aiguilles en meme temps (voir figure 24-9). 
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1 function arreter () < 

2 trace ("fee arreter"); 

3 grandeAio;ulllel_iDC. tourneGrande-O; 

4 pet iteAiguillel me . tournePetite-O; 

5 > 
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demarrer") i 
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function demarrer(a 
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Figure 24-9 

Contrdle de multiples variables depuis le panneau Observateur 
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Gestion des points d'arret 

Pour vous expliquer comment utiliser les points d' arrets pour controler les variables locales des fonc- 
tions, nous allons commencer par modifier legerement l'application afin d'ajouter un second bouton 
Marche. Celui-ci, outre sa fonction de demarrage de la pendule, diminuera l'alpha de la grande 
aiguille. Un second gestionnaire sera ajoute dans le code afin de gerer ce nouveau bouton, de meme 
que nous ajouterons un argument a la fonction demarrerO afin de recuperer la valeur de l'alpha 
envoyee par les deux boutons Marche (voir figure 24-16) : 

1. Creation d'un second bouton Marche : selectionnez le bouton actuel. Appuyez sur la touche Ctrl 
et deplacez en meme temps le bouton afin de le dupliquer. Modifiez ensuite F occurrence du 
nouveau bouton cree (nommez-la marche2_btn). 

2. Modification du code : selectionnez l'image cle 1 du caique Action et ajoutez les parties de code 
en gras dans le script ci-dessous : 

function arreterO { 
trace( "f ct arreter" ) ; 
grandeAiguil 1 el_mc.tourneGrande=0; 
peti teAi guillel_mc. tournePeti te=0; 

} 

function demarrer(a) { 
traceC'fct demarrer" ) ; 
grandeAiguil 1 el_mc._al pha=a ; 
grandeAiguil 1 el_mc.tourneGrande=l ; 
peti teAi guillel_mc. tournePeti te=l; 

} 

// 

stopl_btn.onRelease=function ( ){ 
traceC'BP STOP ACTIONNE" ) ; 
arreter( ) ; 

} 

marchel_btn.onRelease=function ( ){ 
traceC'BP MARCHE ACTIONNE" ) ; 
demarrer(lOO) ; 
} 

marche2_btn.onRelease=function ( ){ 
traceC'BP MARCHE ACTIONNE" ) ; 
demarrer(50) ; 
} 

// 

peti teAi guil lel_mc.tournePetite=0; 
petiteAiguillel_mc.onEnterFrame = function () { 

if (this. tournePeti te==l) 

this._rotation+=l; 

} 

grandeAigui 1 1 el_mc. tourneGrande=0; 
grandeAiguillel_mc.onEnterFrame = function () { 

i f (this .tourneGrande==l) 

this._rotation+=5; 

} 
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3. Insertion d'un point d' arret : ouvrez le script de l'image cle 1 avec Fediteur de script du panneau 
Acti on. Cliquez dans la zone bleue en regard de la ligne de code sur laquelle vous desirez ajouter 
le point d'arret (voir figure 24-10). Dans notre exemple, nous ajouterons un point d'arret a la 
ligne 22 du script (si les numeros de ligne ne sont pas affiches, validez le choix Affichez les 
numeros de ligne dans le menu Option de Fediteur de script). Pour supprimer un point d'arret, 
cliquez de nouveau dessus pour le faire disparaitre. 
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\ Assistant de script 



| function arreter() ( 

trace ("fct arreter"); 
grandeAiguillel_mc. tourneGrande«0; 
pet iteAigui 1 lel_mc . tournePetite"0; 
I > 

I function demarrer (a) < 

trace ("fee demarrer"); 
grandeAigulllel_roc._alpha"a; 
grande Aigui 1 le l_tnc . toucneGrande s 1; 
pettteAiguillel mc.tournePetlte-1; 



I stopl_btn.onRelease-f unction ( ){ 
trace ("BP STOP ACTIONNE") ; 
arreter () ; 

net ion ( ){ 
trace ("BP HARCHE ACTIONNE"); 
demarrer ( 100) ; 



|ji*arche2_btn.onRelea3e"f unction ( ){ 
demarrer (50) ; 



I pet iteAigui Hel_»c. tournePetitcO; 
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Figure 24-10 

Pose d'un point d'arret dans Vediteur de script 



4. Maintenant que F application est modifiee et que vous avez pose un point d'arret, passez dans 
l'environnement de test de Flash. Dans le menu de l'interface auteur, choisissez Control e puis 
selectionnez Deboguer Fanimation ou utilisez les touches clavier Ctrl + Maj + Entree. 

5. Une fois dans l'environnement de test, selectionnez le script de l'image cle depuis le menu derou- 
lant place au-dessus de la fenetre de Fediteur du debogueur afin de vous assurer que votre point 
d'arret est bien present. 
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A noter 

Les points d'arret peuvent egalement etre ajoutes depuis I'editeur du debogueur de la meme maniere que dans 
I'environnement auteur de Flash. 



6. Cliquez sur la fleche verte pour demarrer l'execution de 1' animation. L' animation est desor- 
mais active. Appuyez sur le second bouton Marche pour que le script s'execute jusqu'au point 
d' arret. 

7. Apres Taction sur le bouton, le point d'arret change d' aspect (un pointeur jaune se superpose au 
point rouge) afin d'indiquer que le script est en attente au niveau du point d'arret. Remarquez que 
vous etes actuellement dans le gestionnaire d'evenements onRel ease et que celui-ci apparait dans 
lafenetre Pile d'appel. 
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trace. ("BP STOP ACTICNNE") ; *=■ 
arrecer ( ) ; 

> 

17 n»archel_btn.onRelea3e»function 

18 trace ("BP ft ARC HE ACTICNNE") 

19 demarrer (100) ; 
) 

roarche2_btn.onRe lease=i unction 

32l trace("BP H ARC HE ACTIONNE") I 

3 demarrer (SO) ; 

24 > 

25 // I 

26 petiteAlguillel_mc.tournePetite 

27 petiteAiguillel_mc.onEnterFrame 

28 if (this. tournePetite"-l) 

29 this._rotation+-l; 

30 ) 

31 grandeAiguillel_mc. tourneGrande - 

32 grandeAigui 1 le l_mc . onEnter Frame 

33 if (this. tourneGrande--!) 



1 function arreterQ ( 

2 trace("rct arreter"); 

3 grandeAigui 1 le l_mc . tourneGr ande-0; 

4 pet iteAiguillel_mc. tour nePet ite-0; 

5 ) 

6 function demarrer (a) ( 

7 trace ("fct demarrer"); 

8 grandeAigui 1 le l_mc . _alpho-a; 

9 grandeAigui 1 le l_mc . tourneGr ande= 1 ; 



La pendule 




i MARCHE 




Figure 24-1 1 

Debogage de V application pendule.fla. Des que le programme rencontre un point d'arret, son execution est suspendue 
et il attend une action sur I'un des trois boutons (reperes 1, 2 et 3) pour poursuivre son execution. 
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8. A ce stade du debogage, plusieurs solutions s'offrent a vous. Vous pouvez cliquer sur le bouton 
Sortir du pas a pas (bouton place a 1' extreme droite ; voir repere 1 de la figure 24-11) pour 
passer le point d' arret et demander au programme de s'executer jusqu'a la fin du script (ou 
jusqu'au prochain point d' arret si vous en avez place plusieurs). Vous pouvez aussi cliquer sur le 
bouton Pas a pas detail le (deuxieme bouton en partant de la droite; voir repere 2 de la 
figure 24-11) afin de parcourir toutes les etapes du script ligne par ligne (y compris le code de 
toutes les fonctions). La troisieme solution participe des deux modes precedents. En effet, si vous 
cliquez sur le bouton Pas a pas principal (troisieme bouton en partant de la droite ; voir repere 3 
de la figure 24-11), le code sera execute ligne par ligne mais les instructions incluses dans les 
fonctions ne seront pas parcourues. Nous allons opter pour le mode Pas a pas detail le afin de 
pouvoir observer le deroulement du programme dans la fonction demarrerC ). 

9. Apres le premier clic sur le bouton Pas a pas detai 1 le, le pointeur jaune passe a la ligne suivante 
(celle de Fappel de la fonction demarrer( )). Si vous cliquez de nouveau sur ce bouton, le pointeur 
est place automatiquement a la premiere ligne de la fonction demarrer( ) (a la ligne 7). Remar- 
quez au passage que la fenetre Pile d'appel affiche desormais la fonction demarrer( ) au-dessus 
du gestionnaire qui Fa appelee (voir figure 24-11). Cette information peut se reveler tres interes- 
sante lorsqu'il s'agit de controler les appels imbriques de differentes fonctions. 

10. Afin de pouvoir observer revolution des variables locales de cette fonction, cliquez sur l'onglet 
Locale. La variable locale a (argument de la fonction), initialisee avec la valeur du parametre 
communique lors de l'appel de la fonction (soit 50), s' affiche. Cette valeur peut etre modifiee de 
la meme maniere que la propriete d'un clip. 

Continuez votre progression en cliquant toujours sur le meme bouton. A la ligne 9, 1' instruc- 
tion grandeAiguil lel_mc._alpha=a ; venant d'etre executee, l'alpha de la grande aiguille passe 
a 50 %. 

11. Si vous continuez votre parcours, le pointeur arrive a la derniere ligne de la fonction. Au clic 
suivant, la fonction est terminee, le pointeur et les variables locales disparaissent et les aiguilles 
de la pendule se mettent a toumer. Le debogage est termine. 



Debogueur distant 

Dans le developpement des animations dynamiques, il faut souvent tester des animations directement 
dans le navigateur (dans le Web local ou sur le serveur distant). Cependant, par defaut, le debogueur 
ne peut pas etre utilise pour controler le fonctionnement d'une animation en ligne. Voici la procedure 
a suivre pour deboguer vos applications a distance. 

1. Configuration des parametres de publication de 1' animation a deboguer en ligne : ouvrez la fene- 
tre des parametres de publication (depuis le menu de Finterface auteur, choisir Fichier puis Para- 
metres de publ i cation ou utilisez le raccourci clavier Ctrl + Maj + F12). Dans l'onglet Formats, 
selectionnez les types Flash et HTML. Cliquez sur l'onglet Fl ash et selectionnez Foption Debo- 
gage autorise (voir figure 24-13). Saisissez un mot de passe dans le champ situe en dessous (le 
mot de passe est optionnel mais fortement conseille pour realiser des tests sur votre serveur 
distant...). 
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function arrecer () { 
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stopl_btn. onRelease-f unct ion ( 
trace ("BP STOP ACTIONNE"); 
arreter () j 
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marchel_btn. onRe leaser-function 
trace ("BP H ARC HE ACTIONNE") 
demarrer (100) ; 
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Figure 24-12 

Debogage de I 'application pendule.fla. Le mode Pas a pas detaille permet de parcourir toutes les lignes de code des 
fonctions afin de contrdler les variables locales. 



2. Enregistrez les configurations des parametres de publication et publiez votre animation. A la 
difference d'une publication classique, le fait d'avoir coche Foption Debogage autorise permet 
de generer un fichier supplementaire portant F extension SWD (en plus des fichiers d' extension 
SWF et HTML). C'est ce troisieme fichier qui permettra le debogage en ligne. II faut le telechar- 
ger sur le site distant dans le meme dossier que les deux autres si vous desirez tester votre appli- 
cation en ligne. Dans notre exemple, nous allons nous contenter de tester F application depuis le 
Web local. 

3. Avant d'appeler F application depuis le Web local, il faut cependant activer le debogueur dans 
Flash. Depuis le menu de Finterface auteur, cliquez sur Fenetre puis selectionnez Panneau de 
developpement et cliquez sur Debogueur. Une fois le debogueur ouvert, cliquez sur le bouton 
d'option (situe en haut et a droite du debogueur) puis cochez Activez le debogage a 
di stance. 
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Parametres de publication 



Profil actuel : Defaut 



Formats I Flash HTML 



Version : 



Infos 



Ordre de chargernent : De bas en haut 



Version d'ActlonScript : ActionScript 2.0 v [ Parametres^ 



Options : D Generer un rapport de tadle 
OpToteger contre I'importation 

|~l 0"*"" Im * f hnrr ^* 

. PlP^boqaqe autoris£ 
E Compressor I'anlmation 

M Opumlser pour Flash Player 6 r6S 



^^Mot de passe : | 1234 



Qualite JPEG : 



80 



Definir.. 



0 100 
Elux contlnu : MP3, 16 Kbits/s, Mono 
Son cTevenement : MP3, 16 Kbits/s, Mono [ Definir.. 

□ Neutraliser les parametres audio 

□ Exporter les sons du peripherique 



Securite de lecture locale : Acces au reseau uniquement 



Figure 24-13 

Configuration des parametres de publication pour le debogage distant 



4. Vous pouvez maintenant appeler l'animation depuis le Web local (dans le manager de Wamp 5, 
cliquez l'option local host, puis parcourez les repertoires pour ouvrir le fichier pendule.html). 
Lors de l'appel du fichier, une fenetre vous demande 1' emplacement de l'animation Flash (voir 
figure 24-14). Selectionnez l'option HSte local puis validez en cliquant sur le bouton OK. 
Si vous avez saisi un mot de passe, une nouvelle fenetre vous demande celui-ci. Saisissez-le et 
validez. 

5. Vous etes desormais dans la meme situation que lors des tests effectues precedemment depuis 
l'environnement de controle interne de Flash. Cliquez sur la fleche verte pour demarrer 1' applica- 
tion et utilisez les boutons de gestion des points d'arret comme dans l'exemple precedent (voir 
figure 24-15). 
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Figure 24-14 

Fenetre de debogage a distance 
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Figure 24-15 

Debogage de 1' animation pendule.swf depuis le Web local 
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Probleme avec le navigateur Internet Explorer 



Remarques 

Les textes publies dans cette partie sont directement extraits de la notice de mise a jour publiee par Adobe concer- 
nant ce probleme. 

Pour illustrer la procedure qui permet de corriger ce probleme nous avons utilise la page menu.html de I'application 
du menu dynamique (chapitre 22). 



Suite a la mise a jour d'lnternet Explorer 

Microsoft a publie en mai 2006 une mise a jour d'lnternet Explorer qui change la facon dont ce 
programme traite certaines pages Web recourant aux controles interactifs. Les controles interactifs 
sont des controles ActiveX qui permettent de mettre en place des interfaces utilisateur. Lorsqu'une 
page Web utilise les elements APPLET, EMBED ou OBJECT pour charger un controle ActiveX, 1' interface 
utilisateur du controle reste bloquee jusqu'a ce que F utilisateur F active. Si une page utilise ces 
elements pour charger plusieurs controles, chaque controle doit etre active separement. Par conse- 
quent, Futilisateur peut avoir a activer manuellement les controles ActiveX de certaines pages Web, 
ce qui inclut la page Web par defaut de Flash Player, en cliquant sur le controle ou en appuyant sur les 
touches de tabulation et Entree. 

Pour plus d' informations sur cette modification, consultez le site Web de Microsoft a Fadresse 
http://msdn.microsoft.eom/l ibrary/default.asp?iirl=/workshop/author/dhtml /overview/ 
activating_activex.asp 



3 menu Microsoft Internet Explorer 






| RcNer Eddon Afflchage Favons Ou* ? 






| QprfcMM. - © • [3 S Potato "&F« 


* e 0- ^ a - u la 











CHquez ici pour deplier le menu 



/ 



^ lOquet id pour MBw tt utttef ce coitrcfe | 



Bordure grise entourant 
I'application Flash 



Premier die impose avant 
d'acceder aux fonctionnalites de I'application 



Figure 24-16 

Probleme d'acces a I'application Flash suite a la mise a jour d'lnternet Explorer. 



Solution proposee par Adobe 

Ann d'eviter aux utilisateurs d' avoir a activer Flash Player et pour leur permettre d'interagir avec le 
contenu Flash, Adobe a cree F extension Mise a jour du contenu actif de Flash qui installe deux mode- 
les HTML. Les programmeurs Flash peuvent les utiliser pour integrer les fichiers SWF Flash. 
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Cesmodeles servent d'activer de facon transparente les fichiers SWF integres, sans que l'utilisateur 
ait a intervenir. 

Si vous traitez des pages HTML incluant des fichiers SWF Flash ou tout autre type de controles inte- 
ractifs (par exemple, les pages HTML creees a l'aide du logiciel Dreamweaver et integrant du 
contenu Flash ou tout autre type de contenu interactif), vous devez tenir compte des modifications 
apportees par Microsoft a Internet Explorer. Pour plus de details sur la modification du code HTML 
existant afin d'activer automatiquement les controles ActiveX, consultez les informations et les FAQ 
de la page du Centre des developpeurs de contenu actif d' Adobe : http://www.rnacrorneclia.com/ 
devnet/acti vecontent/ 



Installation de la mlse a jour de Flash 

Voici la procedure a suivre pour installer la mise a jour de Flash et corriger ainsi le probleme avec le 
navigateur Internet Explorer. 



> Macromedia Flash Downloads - Mo/itld Fircfox 



fichier £<*bon Afhchaoe Alera Marque-pages Outfc > 



o o 
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Fl.isli Pi olessioii.il 8 ami Flash Bask 8 

Flash Pfofession.il 8 FLVPIayback 1.0.1 Component Update 

6 20 2006 This update provides fixes for problems related to SMIL support m the initial release of 
the FLVPIayback component It also addresses some issues related to streaming from the 
Flash Media Server and Flash Video Streaming Service (FVSS) partners as well as some minor 
issues related to using custom Ul controls Anyone working with Ihe FLVPIayback components 
should apply this update Installation instructions are included with the download in (he Readme 
file 

O Download the English Update (ZIP, 1 55 KB) 
Flash Professional 8 ami Flash Basic 8 Active Content Update 

4 14 2006 This update provides new publishing templates for Flash Professional 8 and Flash 
Basic 8 so that user experience is not impacted by Microsoft's update to internet Explorer 
regarding handling of some web pages using interactive controls (learn more) All users should 
apply this update 



Request Support 

Contact Product Support 
Contact Customer Service 
OifCUlf it in the Forumi 
Flash Support Plan* 



Additional Flash Resources 

Flash Product Homo 
Flash Developer Canter 
Flash Documentation 
FUfh Event i 

and 

FUfh Professional Events 

Exchange 

Flash Training 



o Download the English Update (ZIP, 1 5 KB) 
" Tj i- flitfiiftl' i T ■ ■ ■ ' i ' ii nun mr j^ i'n- 
^Dow nload the French update (ZIP, 1 7 M 
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0 Download the Italian Update (ZIP, 1 6 KB) 
0 Download the Japanese Update (ZIP, 1 9 KB) 
0 Download the Korean Update (ZIP. 1 7 KB) 
<> Download the Simplified Chinese Update (ZIP, 1 7 KB) 
o Download the Traditional Chinese Update (ZIP, 1 7 KB) 




Ouverturc dc flash8_ac_update_fr.zip 
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O Ouvrir avec CompressedFoldeT (defaut) 



0 Enrogrstrer sur le deque 

C ToujouTj eff ectuer cette action pour ce type de fcNer. 
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FflDMCK 



Figure 24-17 

Telechargement de la mise a jour proposee par Adobe. 
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1. Telechargez V extension Mise a jour du contenu actif de Flash a partirdu site Web Macromedia 
Flash Exchange. Accedez ace site en selectionnant Aide>Flash Exchange dans 1' application Flash 
ou utilisez l'URL suivante (depuis www.adobe.fr cliquez sur Support puis Mise a niveau et selec- 
tionnez Flash dans le menu deroulant) : http://www.adobe.com/support/flash/downloads.html 

2. Recherchez l'extension Mise a jour du contenu actif de Fl ash et telechargez le fichier d' instal- 
lation (voir figure 24-17). Vous pouvez telecharger cette extension sur votre bureau et cliquer 
deux fois pour Finstaller. Vous pouvez egalement l'installer a l'aide d'Extension Manager, 
pendant le telechargement. 

3. Lisez la declaration d' exoneration de responsabilite des extensions Macromedia et consultez la 
licence d'extension d'editeur tiers eventuellement incluse. Selectionnez Accepter pour poursuivre 
Finstallation ou Refuser pour Fannuler. 

4. Redemarrez l'application Flash pour terminer 1' installation. 
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Figure 24-18 

Installation de la mise a jour proposee par Adobe. 



Utilisation des nouveaux modeles HTML 

1. Ouvrez le clip Flash a publier a l'aide des nouveaux modeles HTML de contenu actif. 

2. Accedez a la boite de dialogue Parametres de publication en effectuant Tune des operations 
suivantes : 

- Selectionnez Fichier>Parametres de publication. 

- Dans Tinspecteur Proprietes du document (disponible si aucun objet n'est selectionne), 
cliquez sur le bouton Parametres. 
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3. Dans l'onglet Formats, le type de fichier HTML est selectionne par defaut. Dans le champ 
Fi chi er, utilisez le nom de fichier par defaut correspondant au nom de votre document HTML ou 
entrez un nouveau nom avec l'extension .html. 

4. Cliquez sur l'onglet HTML pour afficher les parametres correspondants. 

5. Selectionnez le modele de contenu actif a utiliser dans le menu deroulant Model e. Vous disposez 
des modeles de contenu actif suivants (voir figure 24-19) : 

- Contenu actif : http - Modele HTML de base permettant d' afficher le contenu Flash. 

- Contenu actif : HTTPS - Ce modele permet d' afficher le contenu Flash au format HTML et 
dirige les utilisateurs qui ne disposent pas de Flash Player vers un serveur HTTPS securise 
pour en telecharger la derniere version. 
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Figure 24-19 

Configuration de l'onglet HTML du panneau des parametres de publication. 



Mise au point des programmes et solution alternative 

Partie VII 

6. Cliquez sur le bouton Publ i er pour publier le fichier HTML. 

7. Executez Applique r la mise a jour du contenu actif dans le menu Commandes (voir figure 24-20). Le 
fichier AC_RunActiveContent. js est alors copie dans le dossier de sortie HTML (le dossier conte- 
nant votre fichier SWF et le modele HTML). Cette action n'est requise qu'une seule fois par 
dossier. Si vous observez ensuite le fichier HTML genere, vous remarquerez qu'un lien au fichier 
JavaScript a ete ajoute automatiquement et que le code d'integration de l'objet Flash a ete aussi 
modifie en rapport (voir figure 24-21). 
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Figure 24-20 

Application de la mise a jour du contenu actif. 
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Figure 24-21 

Fichier HTML apres sa mise a jour. 

8. Chargez le fichier SWF, le modele HTML et le fichier AC_RunActiveContent. js sur votre site 
Web. Si vous appelez de nouveau la page HTML contenant F application Flash, le probleme 
devrait avoir disparu (voir figure 24-22). 



Figure 24-22 

L'qffichage de la page HTML 
contenant V application 
Flash est redevenu normal 
(a comparer avec la 
figure 24-16). 
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Solution alternative AMFPHP 



II existe actuellement plusieurs solutions pour developper rapidement des applications communican- 
tes entre Flash et le serveur (Flex, FlashCom, AMFPHP. . .). Cependant, dans le cadre de cet ouvrage, 
nous avons choisi de ne vous presenter que AMFPHP, qui a l'enorme avantage d'etre gratuit, et qui 
est done accessible a tous. L'objectif de ce chapitre est de vous initier a l'usage de cette technologie 
et non d'exploiter toute la puissance d' AMFPHP car il faudrait y consacrer un ouvrage complet pour 
faire le tour de toutes les applications possibles. Si cette introduction vous seduit et que vous desirez 
l'utiliser dans vos futurs projets, nous vous invitons a visiter le site officiel d' AMFPHP a l'adresse 
suivante : www.amfphp.org^ 

Presentation de Flash Remoting et AMFPHP 

Flash Remoting pour PHP 

Flash Remoting est un ensemble de composants Flash qui permet de creer facilement une passerelle 
de communication entre le client Flash et des ressources serveur (Programme serveur, service Web, 
base de donnees...). 

Pour echanger des donnees avec le serveur, Flash utilise un format binaire specifique nomme AMF 
(Action Message Format) qui permet d'augmenter les performances des transferts. Macromedia a 
developpe plusieurs versions de passerelles pour communiquer avec des technologies serveur telles 
que ColdFusion, Java ou encore .NET. Par la suite, des versions destinees a echanger avec d'autres 
technologies serveur comme Perl (FLAP) ou PHP (AMFPHP) ont ete developpees en Open Source. 
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La classe AMFPHP 

Comme nous venons de le voir, AMFPHP (aussi appele « Flash Remoting pour PHP » ou encore 
« PHP Remoting ») est un developpement Open Source (et done gratuit) destine a exploiter Flash 
Remoting avec la technologie serveur PHP. 

Que le format AMF soit un format binaire permet au player Flash d'executer les serialisations de 
donnees beaucoup plus rapidement que s'il s'agissait d'une chaine de caracteres classique. Avec cette 
technique, il n'est done pas necessaire de transformer les donnees au format XML, comme nous 
Favons vu dans les chapitres precedents, car cela ralentirait considerablement le transfert entre le 
client et le serveur. Les composants Flash Remoting font appel a des methodes distantes d'une classe 
PHP specifique du serveur Web (AMFPHP). Ainsi couplee, la conversion d'un objet Flash sera reali- 
see automatiquement et permettra d'obtenir rapidement un objet de meme type compatible avec la 
technologie PHP. Par exemple, un tableau de variables Flash sera serialise automatiquement cote 
serveur en un tableau de variables PHP en rapport. II en est de meme pour les autres types de donnees 
ActionScript (Array, booleans, null, String, Object et RecordSet), a l'exception des types XML et Date 
pour lesquels la conversion ne pourra pas etre realisee automatiquement (voir tableau 25-1). II est 
important de noter que F application Flash n' attend pas le resultat mais le traite des sa reception. En 
effet, elle adresse les demandes a partir d' ActionScript vers le serveur et recoit les resultats de facon 
asynchrone. 



Tableau 25-1. Types de variables geres par AMFPHP 



Flash 


Php 


Commentaires 


Automatique 


null 


null 




oui 


bool ean 


bool ean 




oui 


String 


string 




oui 


Date 


float 


Conversion manuelle possible par le biais de I'Unixtimestamp. 
Dans ce cas, ilfaut specifier I'attribut "returns" dans les attri- 
buts de la methode methodTabl e. 


non 


Array 


array 




oui 


Object 


associative array 




oui 


XML 


string 


Conversion manuelle possible. Dans ce cas, il faut specifier 
I'attribut "returns" dans les attributs de la methode method- 
Table. 


non 


Recordset 


Resource 


Uniquement de PHP vers Flash 


oui 



Installation de Flash Remoting et d'AMFPHP 

L utilisation de cette technique de communication necessite 1' installation des composants Flash 
Remoting dans votre logiciel auteur Flash et celle des classes AMFPHP sur votre serveur local (ou, 
par la suite, sur votre serveur distant de production). Nous vous proposons de detailler ci-dessous ces 
deux procedures. 
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Installation de Flash Remoting 

Pour installer les composants Flash Remoting, vous devez vous rendre sur le site d' Adobe dedie aux 
composants Flash. Pour trouver facilement Fadresse de cette page, saisissez les mots-cles Flash 
Remoting Composant dans votre moteur prefere, ou bien utilisez directement Fadresse suivante (sous 
reserve que la localisation de cette page n'ait pas change entre -temps) : http://www.adobe.com/fr/ 
products /f 1 ashremoting/downl oads /components/ 



3 Macromedia France - Flash Remoting MX : Composants - Microsoft Internet Explorer 



Rcfter Edttxi AffKhage Favors Qutfe 



Qprecedente - 



u.ddooe . com/fr/pr o&Klsfna&mot^itoMto&lccnvoricriLsl 



Voire comple Contact France (modifier) 
SOLUTIONS PRODUCTS SUPPORT COMMUNAUTtS SOClETt TElECHARGER STORE CMERCMER 

I 



Accuol / Pf odu.(i / Math fUmobng / 

Macromedia Flash Remoting MX : Composants 



Le deveioppement duplications dynamlques avec Macromedia Flash MX et Macromedia Flash 
Remoting MX requiert iVrbfisation des composants Flash Remobng Ces composants font 
evoluer I'environnement auteur de Macromedia Flash MX en y aioutant les interfaces API 
ActionScnpt necessaires a hnvocation des services distants avec Flash Remoting MX Des 
extensions de programmation telies que le debogueur NelConnection. qui permel aux 
deveioppeurs de surveiiier les evenements entre le client et le serveur sonl egalement 
comprises dans les composants Flash Remoting. en plus de foncbons de traitement et de 
liaison des leux d'entegistrements destinees au traitement des donnees dynamiques de bases 
de donnees relalionnelles 

Les composants Flash Remoting son) disponibles pour Flash Professional 8, Flash Basic 8 les 
versions precedents de Flash 

Remarque - Flash doit etre instaiie avant les composants Flash Remoting Veulilez consuiter la 
page de configuration requise de Flash Remoting ou le centre de support" pour plus 
d'mformatirjn s 

•^omposants Macromedia Flash Remoting pour Flash 8 ActjonScripl 

• Conipos^nTsTWrWmww**w*.^^ 2 0 

a Composants Macromedia Flash Remoting pour Flash MX 2004 et Flash MX Professional 

2004 ActionScnpt 1 0 
a Composants Macromedia Flash Remoting pour Flash MX ActionScnpt 1 0 
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Figure 25-1 

Page de telechargement des composants Flash Remoting. 



Cliquez sur le lien correspondant a la version de votre logiciel auteur (soit Flash 8 dans notre cas, voir 
figure 25-1). Dans la nouvelle page, choisissez ensuite la langue et le type d'OS de votre ordinateur et 
cliquez sur le lien de telechargement des composants. Une fois le fichier d' installation telecharge sur 
votre ordinateur, cliquez dessus pour lancer Finstallation sur votre ordinateur (voir figure 25-2). 

Ouvrez ensuite le logiciel auteur Flash, puis un nouveau document Flash (Ctrl+N). Pour vous assurer 
que les nouvelles classes liees aux composants Flash Remoting sont disponibles dans Fediteur de 
script du panneau Action, cliquez sur le bouton + en haut du panneau (voir figure 25-3), puis selec- 
tionnez Foption Remoting en bas de la liste deroulante. Les differentes classes Remoting disponibles 
doivent alors apparaitre dans la seconde liste. 
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Figure 25-2 

Installation des 
composants 
Flash Remoting, 



[B Macromedia Mash Remoting InstdllShicId Wizard 




Inst dilation dc Macromedia Flash Remoting 

Les f orations son* en cours oTnstaltOon. 



macromedia 



Macromedta Flash Remoting est en cours tffcwtalatfon. (.'operation peut 
prendre quekjues minutes. 
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Figure 25-3 

Differentes classes disponibles de Flash Remoting. 
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Les classes ActionScript pour Flash Remoting permettent de configurer Flash Remoting, d'interagir 
avec les services distants et de manipuler les donnees sur le client. Le tableau 25-2 presente les prin- 
cipals classes Flash Remoting que vous pourrez utiliser dans vos futures applications. 



Tableau 25-2. Principales classes ActionScript pour Flash Remoting 



Classes 


Description 


Connection 


Permet de creer etd'utiliser des connexions a des services. Par exemple, lamethode Connection . set- 
Credenti al s( ) fournit les justificatifs d'identite a presenter au serveur de la passerelle. 


DataGlue 


Permet de lier des objets RecordSet a des composants Flash, tels que ListBoxou ComboBox, disposant 
d'etiquettes ayant des donnees associees. Par exemple, les methodes DataGlue.bindFormatS- 
tringsf ) et DataGl ue. bind Format Function ( ) designent I'objet RecordSet a utiliser pour formater le 
composant d'interface et pour indiquer a Flash comment formater les etiquettes et les donnees du com- 
posant a partir de I'objet RecordSet. 


Faul tEvent 


Cetobjetest renvoye en tantqu'argumentde lamethode de gestion des erreurs que vous specifiez dans 
I'objet Responder. II contient les informations d'erreur renvoyees lorsqu'un appel a une fonction de ser- 
vice n'aboutit pas. 


NetDebug 


Obligatoire pour le Debogueur NetConnection. Gere la connexion locale entre I'application Flash a 
deboguer et le debogueur NetConnection. 


PendingCall 


Generee sur chaque appel a une methode d'un objet Service. Contient la propriete responder, qui 
obtient ou definit un objet Responder pour un objet PendingCall. 


RecordSet 


Accede aux objets RecordSet renvoyes par un service et les manipule. Cree egalement des jeux d'enre- 
gistrements cote client. Les objets RecordSet represented en principe les resultats de requetes SQL et 
correspondent aux objets de requete. 


Rel ayResponder 


Objet Responder qui transmet les resultats et les erreurs aux fonctions correspondantes sur I'objet specifie. 


Resul tEvent 


Cet objet est renvoye en tant qu'argument de la methode de gestion des resultats que vous specifiez 
dans I'objet Responder. II contient le resultat renvoye par une fonction de service. 


Servi ce 


Represents une reference a un service client specifique et aux methodes que ce service presente. Les 
services distants consistent en des modules de serveur d'applications exploitant des technologies ser- 
veur telles que PHP, par exemple. 



Installation d 'AMFPHP 

Pour installer les classes AMFPHP cote serveur, commencez par les telecharger depuis le site 
www.amfphp.org. Depuis la page d'accueil de ce site, cliquez sur le lien Download pour acceder a 
l'espace de telechargement de SourceForge (voir figure 25-4). Cliquez sur le bouton de telecharge- 
ment de la derniere version stable de la suite AMFPHP afin de rapatrier le fichier compresse des classes 
sur votre ordinateur (dans nos exemples, nous avons utilise la version 1.2.5). 

Afin de tester cette technique de communication, nous allons creer au prealable un dossier SITEamf- 
php dans le repertoire \www\ du serveur Wamp (soit C:\wamp\www\SITEamfphp\). A l'interieur de ce 
nouveau repertoire, creez un autre dossier nomme f 1 ashservi ces comme le suggere la documentation 
du site officiel. 

Une fois le fichier AMFPHP disponible sur votre ordinateur, decompressez-le, puis copiez tout le 
contenu du repertoire dans le dossier SITEamfphp\fl ashservices\ que vous venez de creer (voir 
figure 25-5). 
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Figure 25-4 
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Demarrez Dreamweaver et creez un nouveau site nomme SITEamfphp dont le dossier racine local 
sera configure avec le repertoire C : \wamp\www\SITEamf php\ nouvellement cree (voir figure 25-6). 



Definition du site pour SITEamfphp 



Categorie 



Infos distances 
Serveur devaluation 
Vofega 
Design Notes 

Mise en forme de le carte du site 
Colonnes en mode Fichier 
Contribute 



Infos locales 



tjomdusite: SITEamfphp 
Dossier racine k>cal< 

0 Actualiser automebquement la (see des fichiers beaux 
Dossier des images par def aut : t3 



Liens relatif s a : ©Un document O La racine du site 



AdresseHTTP: | http:// 



Cette adresse est utilisee pour les lens 
relatif s au site, et pour permettre au 
Verificateur de (ens de d&ecter les tens 
HTTP qui font reference a votre propre site 

Liens sensible a la casse : □ ytiliser verification des liens sensfcle a la casse 
Cache: 0 Activer le cache 



Le cache conserve les informations sur les 
fichiers et les actifs du site, ce qui accelere 
les fonctionnalites du panneau des actifs, 
de la gestton des tens et de la carte du site. 



OK | Annuler Aide 



Figure 25-6 

Configuration d'un nouveau site SITEamfphp dans Dreamweaver. 



Ouvrez ensuite le fichier passerelle gateway. php et lancez une recherche dans le code de cette page 
avec le mot-cle setCharsetHandler. Supprimez le point-virgule place devant l'instruction concernee 
afin de la « decommenter » (attention, il s'agit de l'instruction situee a la ligne 121 et non des diffe- 
rentes instructions semblables placees dans les commentaires en debut du code). Enregistrez ensuite 
ce fichier pour memoriser votre configuration. Le fait d' avoir valide cette instruction permettra 
d'activer Fencodage automatique des caracteres speciaux fran?ais (ISO-8859-1) et de beneficier ainsi 
du support pour la langue fran?aise. 

| $gateway->setCharsetHandler("utf8_decode" , "ISO-8859-1", "ISO-8859-1"); 
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Figure 25-7 

Activer le support de la langue francaise en decommentant la ligne $gateway->setCharsetHandler dans lefichier 
gateway.php. 



Desactivez le debogage si vous passez en production 

Lorsque votre systeme sera au point sur votre serveur local, pensez a modifier la valeur de la constante 
PR0DUCTI0N_SERVER en la passant a la valeur true de sorte que le systeme de debogage ne soit pas active en 
ligne : 

def ine( "PRODUCTION_SERVER" , true) ; 
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Connexion de type String avec AMFPHP 

Pour illustrer une premiere utilisation tres simple d' AMFPHP, nous vous proposons de realiser une 
application Flash nommee maFacture.fi a qui utilisera une classe service PHP nominee calcul Finan- 
cier. Dans notre exemple, l'application Flash utilisera une methode de cette classe cal cul Financier 
nommee cacul Tva qui retournera le montant de la TVA correspondant a la valeur envoyee de Flash a 
PHP. Evidemment, ce genre d'application ne necessite pas l'usage d' AMFPHP car elle peut etre tres 
rapidement effectuee par une simple fonction ActionScript locale, mais la simplicite de cette applica- 
tion vous permettra de mieux comprendre le fonctionnement d'un transfert de donnees realise a 
l'aide d' AMFPHP, et par la suite de 1' adapter facilement a des projets plus complexes. 



Creation d'une classe service AMFPHP 

Commencons par creer la classe cal cul Fi nanci er en PHP. Pour cela, ouvrez un nouveau fichier dans 
Dreamweaver et enregistrez-le dans le repertoire /services/ (situe dans le dossier /fl ashservices/) 
en prenant soin d'utiliser le meme nom que celui de la classe (done calcul Fi nanci er.php). 

Comme nous Favons deja vu au chapitre 13, la declaration d'une classe commence par le mot-cle 
cl ass suivi du nom de la classe (voir figure 25-8). La premiere methode consiste a declarer ce que 

doit etre le constructeur de la classe soit, en PHP 5, constructs ) (notez que si vous desirez conser- 

ver la compatibilte avec PHP 4, vous pouvez aussi utiliser calculFinancierO au lieu de 

constructO ). Dans le constructeur, nous placerons un objet particulier appele methodTable. Cet 

objet Array contiendra les differentes methodes de la classe et leurs proprietes respectives (voir 
figure 25-8). Dans notre exemple, nous n'aurons qu'une seule methode nommee cal cul Tva et ses 
proprietes. Parmi ces proprietes, nous aurons notamment la propriete description, qui permettra de 
preciser l'usage de la methode, la propriete access, configuree avec la valeur remote afin d'autoriser 
Flash a acceder a la methode (dans le cas contraire, la valeur serait private), la propriete arguments, 
qui precisera le nom de l'argument utilise par la methode (dans un array( ) afin de pouvoir declarer 
plusieurs arguments si besoin), et enfin la propriete returns qui indiquera le type de donnees retour- 
nees par la methode. 

class calcul Financier { 

function constructO ( 

//Definition de methodTable 
$this->methodTable = array( 
"methodTva" => array( 

"description" => "Calcul de la TVA", 

"access" => "remote", 

"arguments" => array ( "val eurHt" ) , 

"returns" => "String" 

) 

) ; //Fi n de methodTable 
} // Fi n du constructeur 

En dessous du constructeur, nous devons maintenant declarer la methode cal cul Tva. Le fonctionne- 
ment de celle-ci sera tres simple : elle recevra en argument la valeur HT (variable $val eurHt), puis 
une simple ligne de code permettra de calculer la TVA en rapport (application d'une TVA a 19,6%). 
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Enfin, le mot-cle return introduira la reponse retournee a l'application Flash, soit une phrase conca- 
tenee avec le montant de la TVA precedemment calculee. 

//Definition de la methode "methodTva" 
function methodTva (SvaleurHt) { 

$valeurTva=$valeurHt * 0.196; 

return " Voici le montant de la TVA = " . $val eurTva ; 



Enregistrez ensuite votre fichier et appelez le depuis le Web Local pour vous assurer qu'aucune erreur 
n'est retournee par l'interpreteur PHP. L'appel de la classe dans le Web Local est uniquement effec- 
tue pour s'assurer que celle-ci ne contient pas d'erreur (auquel cas elle doit afficher une simple page 
blanche sans message d'erreur). 
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Figure 25-8 

Creation de la classe service PHP calculFinancier. 
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Creation d'une application Fiash Remoting 

II faut maintenant creer F application Flash Remoting. Pour cela, ouvrez un nouveau document Flash 
puis enregistrez-le sous le nom maFacture.fla dans le repertoire /SITEamfphp/. Depuis le menu de 
Flash, ouvrez la bibliotheque commune de Remoting (Fenetre>Bibl iotheques communes>Remoting : 
voir - figure 25-9). Ouvrez aussi la bibliotheque du document actif (Ctrl+L), puis selectionnez les 
composants dans la bibliotheque Remoting et faites-les glisser dans la bibliotheque du document 
actif (figure 25-9). 
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Figure 25-9 

Chargement des composants Remoting dans la bibliotheque du document actif. 



Placez-vous sur la premiere image du scenario principal puis ouvrez l'editeur de script pour y copier 
les instructions d' importation des differentes classes necessaires au fonctionnement de Flash Remo- 
ting (voir code ci-dessous ; pour plus de precision sur ces classes, reportez-vous au tableau 25-2). 



// Import des Classes Remoting 

import mx. remoting. Service; //Importer la 

import mx. remoting. Pendi ngCa 1 1 //Importer 



classe Service 

la classe PendingCal 
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import mx. rpc. Rel ayResponder //Importer la classe Rel ayResponder 
import mx.rpc. ResultEvent //Importer la classe ResultEvent 
import mx.rpc.FaultEvent; //Importer la classe FaultEvent 

Afin de disposer des fonctionnalites du debogeur NetDebug, nous allons importer aussi la classe en 
rapport et F initialiser pour qu'il soit actif (voir code ci-dessous). 

//Import de la classe NetDebug et initialisation du debogeur 

import mx. remoting. debug. NetDebug ; 

mx. remoting. debug. NetDebug. initial ize() ; 

Pour creer la connexion avec le service AMFPHP, nous allons creer un objet Service nomme 
maConnexion. Le premier parametre correspond a la localisation du fichier passerelle gateway .php, le 
second parametre n'est pas utilise dans notre exemple et nous le remplacerons done par la valeur 
null, enfin, le troisieme parametre correspond au nom de la classe service PHP ciblee, que nous 
avons creee dans la partie precedente (cal cul Financier). 

// Creation de la connexion avec la classe PHP calcul Financier 

url Passerel le="http://l ocal host/SITEamfphp/f 1 ashservices /gateway .php" ; 

var maConnexion :Service=new Service(url Passerel le.nul 1 , "cal cul Financier" ) ;_ 

La ligne de code qui suit permet d'appeler la methode cal culTva de la classe cal cul Financier en lui 
passant comme parametre la valeur HT de la facture (soit, dans l'exemple, la valeur numerique 100). 
Notez que le resultat sera retourne dans un objet PendingCall nomme monRetour. 

// Appel de la methode PHP methodTva avec passage du parametre 

var monRetour :PendingCall=maConnexi on. methodTva (100) ; 

II nous faut maintenant definir les deux gestionnaires dans lesquels nous allons definir les traitements 
a effectuer lors de la reception de la reponse du serveur. Deux traitements devront etre prevus. Le 
premier, traitementResultat, permettra de gerer dans Flash le resultat retourne par le serveur, alors 
que le second, nomme traitementErreur, devra gerer les erreurs si le transfert echoue. Avant de defi- 
nir ces deux gestionnaires, nous devons creer un objet Rel ayResponder afin de definir les noms des 
deux gestionnaires presentes precedemment. Pour cela, le constructeur de Fobjet Rel ayResponder 
utilise comme second et troisieme parametres le nom des methodes gerant les objets ResultEvent et 
FaultEvent renvoyes par la methode de service. En effet, lorsqu'un appel a une fonction de service 
aboutit, un objet ResultEvent est renvoye sous forme d'argument a la methode de gestion des resul- 
tats. L' objet ResultEvent dispose d'une propriete result, qui stocke Fobjet resultat renvoye par la 
fonction de service. Dans notre exemple, le resultat sera materialise par une simple chaine de carac- 
teres (recuperable avec resul tat . resul t), mais, dans d'autres cas, celui-ci pourra contenir un resultat 
d'un type different. Pour cette raison, la gestion de Fobjet resultat exige une connaissance de la fonction 
de service PHP concernee afin de bien definir le type de resultat retourne. 

II Gestion du resultat asynchrone et definition 

II (j es m ethodes de traitement des resultats et des erreurs 

monRetour. responder = new Rel ayRespondertthi s , "traitementResultat", "traitementErreur"); 
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II Methode de gestion du resultat 

function traitementResul tat( resultat:ResultEvent ):Void { 
//Recevoir le resultat 

trace( "Resultat recu cote Flash :"+resultat. result ); 

} 

// Methode de gestion des erreurs 

function traitementErreur( erreur:FaultEvent ) : Voi d { 
//Recevoi r 1 ' erreur 

trace( "Erreur connexion : "+erreur .faul t .f aul tstring) ; 
) 
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\ Assistant de script 



Import des Classes Rerooting 
I import mx.renoting. Service; 
import n>Jc . rernot ing. PendingCall 

import mx.rpc.RelayResponder // importer la classe Re lay Res ponder 
I import mx.rpc.ResultEvent // importer la classe ResultEvent 
| Import mx.rpc.PaultCvent; // importer la classe FaultEvent 

Import de la classe NetDebug et initialisation du debogeur NetDebug 
I Import mx.renoting. debug. NetDebug; 
| mx.renoting. debug. Net Debug, initialised I 

Creation de la connexion avec la classe PHP calculFinanc 

I uclPa89ecelle B "http:// localhost/SITEomf php/f las hser vices/ gateway . php"; 

I var roaConnex ion: Service-new Service (urlPasserelle, null, "calculFinanc ler") ; 

— Appel de la methode PHP methodTest avec passage du paramei 

I var monRetour : PendmgCa^l-maConnex ion .methodTva [ 100) ; 

Gestion du resultat asynchrone et definition 

des methodes de traitement des resultats et des erreurs 

| monRetour. responder - new RelayResponder (this, "traitementResultat", "traitementErr* 

Methode de gestion du resultat 

[function traitementResultat ( resultat : ResultEvent ) :Void { // recevoir le resultat 
I trace ( "Resultat requ cote Flash : "+resultat . result ); 
I } 

Methode de gestion des erreurs 

I function traitementErreur ( erreur : FaultEvent ) :Void ( // recevoir l'erreur 
I trace ("Erreur connexion I "+erreur . fault . f aultstr ing) | 
I ) 



I//- 
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Figure 25-10 

Configuration de V application Flash maFacture.fla . 
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Test de I'application avec NetDebug 

Maintenant que la classe de service PHP est definie et que I'application Flash a ete configuree correc- 
tement, nous pouvons passer a la phase de test du systeme de communication. Pour cela, nous allons 
mettre en ceuvre le debogeur NetConnection Debugger. Depuis le menu de Flash activez le panneau 
du debogeur: Fenetre>Autres panneaux>NetConnection Debugger, puis accrochez le panneau du 
debogeur en dessous du panneau Acti on (voirfigure 25-1 1). 
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Figure 25-11 

Activation du panneau NetConnection Debugger. 

Enfin, testez I'application Flash (Ctrl+Entree) : la fenetre de I'application maFacture.swf doit appa- 
raitre, ainsi que le panneau de sortie dans lequel doit figurer le resultat renvoye par le serveur (voir 
figure 25-12) : 



Resultat recu cote Flash : Voici le montant de la TVA = 19.6 
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Figure 25-12 

Test de V application maFacture.swf. 



Dans le panneau NetConnection Debugger, vous devez voir apparaitre 4 evenements (pour consul- 
ter le detail d'un evenement, cliquez sur le nom de l'evenement concerne dans la zone Evene- 
ments, voir figure 25-13). Le premier correspond a la connexion etablie entre Flash et le serveur 
(initiee par var maConnexi on : Servi ce=new ServiceO ), le second correspond a 1' envoi du parametre 
(soit la valeur numerique 100 dans notre exemple), le troisieme indique la connexion de la 
reponse asynchrone du serveur, et le quatrieme coiTespond a la reponse retournee par le serveur 
(soit, dans notre exemple, le montant de la TVA correspondant a la valeur 100 : Voi ci 1 e montant de 
la TVA = 19.6 ) 
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Figure 25-13 

Evenements generes par NetConnection Debugger. 



Connexion de type RecordSet avec AMFPHP 

Afin d'illustrer l'utilisation d' AMFPHP et de RecordSet qui permettent d'interfacer une base de 
donnees MySQL, nous allons realiser une application qui aura pour fonction d'afficher la liste des 
differents adherents de la base de donnees sport_db, creee au chapitre 16 de cet ouvrage. 

Creation des classes service AMFPHP 

Pour ce second exemple, nous allons creer deux classes PHP. La premiere sera une classe dediee a la 
connexion MySQL et nous la nommerons connexionMysql (ainsi, si besoin, elle pourra etre utilisee 
par d'autres classes de services par la suite) ; la seconde sera la classe service proprement dite, elle se 
nommera baseSport, assurera le traitement de la demande client, et renverra le jeu d'enregistrements 
en retour a F application Falsh. 
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Classe connexionMysql 

Commencons par creer la classe connexi onMysql en PHP. Pour cela, ouvrez un nouveau fichier dans 
Dreamweaver et enregistrez-le dans le repertoire /services/ (situe dans le dossier /fl ashservices/) 
en prenant soin d'utiliser le meme nom que celui de la classe (done connexionMysql .php). 

Le debut du fichier de classe commence, comme d'habitude, par le mot-cle cl ass suivi du nom de la 
classe. Suit une serie d' initialisations de 4 variables qui contiendra les differents parametres de 
connexion a la base de donnees (revoir si besoin la figure 18-12 pour vous rememorer le script de 
connexion PHP a une base de donnees). Notez que les parametres de connexion utilises sont les 
memes que ceux du compte utilisateur sport , cree dans les chapitres precedents. Si toutefois vous 
n'avez pas encore cree cet utilisateur, sachez qu'il est aussi possible de se connecter a la base 
sport_db en utilisant le compte root pas defaut et en ne mettant pas de mot de passe (attention, ce 
compte root ne doit etre utilise que sur votre serveur local pour des raisons de securite evidentes). 

class connexionMysql 
{ 

var Shostname = "1 ocal host" ; 

var Sdatabase = "sport_db"; 

var Susername = "sport"; 

var Spassword = "eyrolles"; 

La premiere methode consiste a declarer ce que doit etre le constmcteur de la classe, soit 

construct () en PHP 5(notez que si vous desirez conserver la compatibilte avec PHP 4, vous 

pouvez aussi utiliser connexionMysql ( ) a la place de constructO ). Dans ce constmcteur, nous 

placerons deux instructions. La premiere permettra d'initialiser un identifiant de connexion appele 
$connexion en se referant a trois des parametres declares au debut de la classe ($hostname, $username 
et $password). La seconde instruction permettra de selectionner la base de donnees a utiliser se refe- 
rant a Fidentifiant de connexion precedemment defini ($connexion) et au quatrieme parametre contenant 
le nom de la base de donnees ($database). 

//Constmcteur de la classe 

function constructO 

{ 

Sconnexion = mysql_pconnect($this->hostname, $this->username, $this->password) ; 
mysql_select_db($this->database, Sconnexion) ; 

} 

En dessous du constmcteur, nous devons maintenant declarer la methode qui sera utilisee pour 
soumettre la requete passee en parametre ($sql ) a la base de donnees. Cette methode renverra le jeu 
d'enregistrements correspondant en retour ($rs). 

function requete ($sql) 
{ 

$rs = mysql_query($sql ) ; 
return $rs; 

} 
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Terminez ensuite la classe en ajoutant une accolade fermante (voir le fichier complet de la figure 25-14). 
Enregistrez votre fichier et testez-le si besoin en 1' appelant depuis le Web Local (Fappel de cette 
classe de facon isolee doit afficher une page blanche, mais aucun message d'erreur ne doit apparaitre. 
Revoyez le code pour corriger l'erreur dans le cas contraire). 
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var (hostnaae > "localhost"; 
vat (database ■ "spoEt_db"; 
vat (usernaae > "toot"; 
vat (password ■ ""; 

// Constxucceuc de la classe 

function constEUCtf) 
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(connexion ■ »ysqlj>connect(*thi3->hostna«e, t'Ju;->usernaae / ( thi3->password) ; 
avsql_select_db((chi3->databa^e, (connexion) ; 
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Figure 25-14 

Creation de la classe service PHP connexionMysql. 



Classe baseSport 

Avant de commencer Fecriture de la classe, nous ajouterons une instruction au debut du fichier pour 
inclure la classe connexi onMy sql precedemment creee, afin de pouvoir disposer de ses methodes dans 
cette nouvelle classe. 

incl ude_once( "connexionMysql .php" ) ; 

Le debut du fichier de classe commence comme d'habitude par le mot-cle cl ass suivi du nom de la 
classe, soit baseSport dans notre cas. Une fois encore, la premiere methode a declarer dans une classe 
doit etre le constructeur de la classe soit constructs ) en PHP 5 (notez que si vous desirez conserver 
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la compatibilite avec PHP 4, vous pouvez aussi utiliser baseSportO au lieu de construct^) ). 

Comme dans la classe calcul Financier de l'exemple precedent, nous placerons dans le constructeur 
un objet particulier appele methodTabl e. Cet objet contiendra les differentes methodes de la classe et 
leur proprietes respectives (voir figure 25-15). Dans notre exemple, nous n'aurons qu'une seule 
methode nommee 1 i steAdherents et ses proprietes. Parmi ces proprietes, nous aurons notamment la 
propriete description, qui permettra de preciser Fusage de la methode, la propriete access, configu- 
red avec la valeur remote arm d'autoriser Flash a acceder a la methode, et enfin la propriete returns, 
qui indiquera le type de donnees retournees par la methode (soit RecordSet dans notre cas). 

class baseSport 
{ 

var SconnexionSport; 
function constructO { 

// definition de methodTable 
$this->methodTable = array( 

"1 i steAdherents" => array( 

"description" => "renvoi la liste des adherents", 

"access" => "remote", 

"returns" => "RecordSet" 

) 

);//fin de methodTable 

$this->connexionSport = new connexionMysql ( ) ; 

} 

En dessous du constructeur, nous devons maintenant declarer la methode qui definira la requete SQL 
a utiliser pour generer le jeu d'enregistrements contenant la liste des adherents (1 i steAdherents ( )). 
Dans cet exemple, la methode n'a pas d' argument. Par la suite, nous verrons qu'il peut etre interes- 
sant de passer un parametre a cette methode afin de creer des filtres selon une information envoyee 
par le client Flash. La premiere ligne de cette methode permet de memoriser la requete SQL dans une 
variable que nous nommerons $sql. La seconde ligne appellera la methode requeteO de la classe 
connexi onMysql afin de soumettre la requete SQL passee en parametre au serveur de base de donnees. 
Le jeu d'enregistrements ainsi recupere ($resultat) sera ensuite retourne par la methode. 

function listeAdherentsO 
{ 

$sql = "SELECT id .nom.prenom.anneeNai ssance FROM adherents"; 

Sresultat = $this->connexionSport->requete($sql ) ; 
return $resultat; 

} 

Terminez ensuite la classe en ajoutant une accolade fermante (voir le fichier complet de la figure 25- 
15). Enregistrez votre fichier et testez-le si besoin en Fappelant depuis le Web Local (l'appel de cette 
classe de facon isolee doit afficher une page blanche et aucun message d'erreur ne doit apparaitre. 
Revoyez le code pour corriger l'erreur dans le cas contraire). 
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function llsteAdhecenuO 
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Sresultat - ( this->connexion5port->requete(.f sql) ; 
recucn fcesultat; 
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Figure 25-15 

Creation de la classe service PHP baseSport. 



Creation d'une application Flash Remoting avec RecordSet 

II faut maintenant creer 1' application Flash Remoting. Pour cela, ouvrez un nouveau document Flash, puis 
enregistrez-le sous le nom mesAdherents.fi a dans le repertoire /SITEamf php/. Depuis le menu de 
Flash, ouvrez la bibliotheque commune de Remoting (Fenetre>Bibliotheques communes>Remoting : revoir 
si besoin la figure 25-9). Ouvrez aussi la bibliotheque du document actif (Ctrl+L), puis selectionnez les 
composants dans la bibliotheque Remoting et faites-les glisser dans la bibliotheque du document actif. 

Placez-vous sur la premiere image du scenario principal et ouvrez ensuite Fediteur de script pour y 
copier les instructions d'importation des differentes classes necessaires au fonctionnement de Flash 
Remoting (voir code ci-dessous ; pour plus de precision sur ces classes, reportez-vous au tableau 25-2). 

// Import des Classes Remoting 

import mx. remoting. Service; //Importer la classe Service 
import mx. remoting. PendingCall //Importer la classe PendingCall 
import mx. rpc. Rel ayResponder //Importer la classe Rel ayResponder 
import mx.rpc.ResultEvent //Importer la classe ResultEvent 
import mx.rpc.FaultEvent; //Importer la classe FaultEvent 
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Creation de la connexion avec la classe PHP baseSport 

I urlPa33erelle*"http:/ / localhost/SITEairrphp/riashaervices/ gateway, php"; 
I maConnexion - new Service (ur lPasserelle, null, "baseSport") ; 

I// Appel de la rnethode PHP listeAdherents 

Ivar nK)nRetour:PendingCall - maConnexion. listeAdherents () ; 

C-estion du resultat asynchrone et definition 

ties methodes de traitereent des resultats et des 

| ironRetour . responder ■ nee RelayResponder (ecouteur, "traitementResultat", ' 

Gestionnaire du resultat envoye par AHFPHP 
| ecouteur. traitementResultat * £unction(resultat:R.esultEvent) : Void 

// creation du pointeur de 1'iterateur 
var pointeur : Iterator - resultat . result . (jet Iterator () ; 

// Boucle sur les enregistreroents du resultat 
while (pointeur .hasHext () ) 



< 



17 



Document 
mesAdherents.fla 



var enreglstre»ent:C*oect ■ pointeur .next () ; 

trace |" *| s 

trace ( "Nom- "+enregi3trement . notn) ; 
trace ("Prenow" "+enregistrement . prenom) ; 

trace (Tate naissance" "+enreglstrement.anneeNais3ance) ; 



// Gestionnaire des eventuelles erreurs envoyees par AHFPHP 

ecouteur. traitementErreur ■ function (resultat:FaultEvent) :Void 
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Figure 25-16 

Configuration de V application Flash mesAdherents.fla. 

Contrairement a la premiere application d'une simple connexion, nous allons avoir besoin d' importer 
deux classes supplementaires pour gerer des objets RecordSet (voir le code ci-dessous). 



import mx.remoting. RecordSet; //Importer la classe RecordSet 
import mx.utils. Iterator; //Importer la classe Iterator 

Afin de disposer des fonctionnalites du debogeur NetDebug, nous allons importer aussi la classe en 
rapport et Finitialiser pour qu'il soit actif (voir code ci-dessous). 

//Import de la classe NetDebug et initialisation du debogeur 
import mx. remoting. debug. Net Debug; 
mx.remoting. debug. NetDebug. initialize( ) ; 

Nous devons creer dans un premier temps un objet ecouteur pour gerer les gestionnaires des resultats. 

//creation d'un objet ecouteur 
var ecouteur:Object = new ObjectO; 
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Comme dans le premier exemple, pour etablir la connexion avec le service AMFPHP, nous allons 
creer un objet Service nomme maConnexion. Le premier parametre correspond a la localisation du 
fichier passerelle gateway. php, le second parametre n'est pas utilise dans notre exemple et nous le 
remplacerons done par la valeur null, enfin, le troisieme parametre correspond au nom de la classe 
service PHP ciblee creee dans la partie precedente (baseSport). 

// — Creation de la connexion avec la classe PHP baseSport 

url Passerel le="http: //local host/SITEamfphp/f 1 ashservices/gateway.php" ; 

maConnexion = new ServiceturlPasserelle, nul 1 , "baseSport" ) ; 

La ligne de code qui suit permet d'appeler la methode 1 isteAdherents de la classe baseSport (sans 
passer de parametre dans cet exemple, mais nous pourrions le faire par la suite en indiquant un critere 
arm de personnaliser un filtre de la requete SQL). Notez que le resultat sera retourne dans un objet 
PendingCall nomme monRetour 

// — Appel de la methode PHP 1 isteAdherents 
| var monRetour:PendingCall = maConnexion .1 isteAdherentst ) ; 

II faut a present definir les deux gestionnaires dans lesquels nous allons definir les traitements a effec- 
tuer lors de la reception de la reponse du serveur. Deux traitements devront etre prevus. Le premier, 
traitementResultat, permettra de gerer dans Flash le resultat retourne par le serveur, alors que le 
second, nomme traitementErreur, devra gerer les erreurs si le transfert echoue. Avant de definir ces 
deux gestionnaires, nous devons creer un objet RelayResponder afin de definir les noms des deux 
gestionnaires presentes precedemment. La methode est semblable au premier exemple deja commente, 
sauf que, dans ce cas, nous utiliserons Fobjet ecouteur comme premier parametre et que la propriete 
resul t de Fobjet Resul tEvent sera ici un jeu d'enregistrements, et non une simple chaine de caracteres. 

Notez que le gestionnaire de traitement du resultat (traitementResultat) utilise un objet Iterator 
(poi nteur) afin de controler la boucle whi 1 e, qui a pour fonction de parcourir tous les enregistrements 
du jeu. Le corps de cette boucle contient le traitement a appliquer a chaque enregistrement. Dans 
notre exemple, nous nous contentons d'afficher chaque champ a l'aide de la fonction trace, mais 
nous pourrions tres bien leur appliquer un traitement plus complexe, selon les besoins de F application. 

// Gestion du resultat asynchrone et definition 

// (jgg m ethodes de traitement des resul tats et des erreurs 

monRetour. responder = new RelayResponder(ecouteur, "traitementResultat", 
^♦"traitementErreur" ) ; 

// Gestionnaire du resultat envoye par AMFPHP 

ecouteur. traitement Resul tat = f unction (resul tat: Resul tEvent) : Voi d 

{ 

// creation du pointeur de 1'iterateur 

var pointeur: Iterator = resul tat . resul t.getIterator( ) ; 

// Boucle sur les enregistrements du resultat 

whi le(poi nteur. hasNextO) 

f 

var enregistrement:Object = pointeur. next( ) ; 

trace( " " ) ; 

trace( "Nom= "+enregi strement.nom) ; 

trace( "Prenom= "+enregistrement.prenom) ; 

traceC'Date naissance= "+enregi strement. anneeNai ssance) ; 
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} 

) 

// — Gestionnaire des eventuelles erreurs envoyees par AMFPHP 
ecouteur.traitementErreur = function (resultat:FaultEvent):Void 
{ 

trace ("Attention, erreur : " + resultat. fault. faultstring) ; 

} 



Test de I'application avec NetDebug 

Testez maintenant I'application Flash (Ctrl+Entree). La fenetre de I'application mesAdherents.swf 
doit apparaitre, ainsi que le panneau de sortie, dans lequel doit figurer le resultat renvoye par le 
serveur (voir figure 25-17). Dans cet exemple, le resultat correspond au jeu d'enregistrements 
retoume par le serveur ; chaque groupe d' informations sur un adherent est affiche dans le panneau de sortie 
a chaque tour de la boucle whi 1 e(pointeur . hasNext( ) ), et cela jusqu'a la fin de l'objet RecordSet. 
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// Import des Classes Rerooting 

import rax. reacting. Service; // importer la classe Service 
import rax. reacting. PendingCall; // imporcer la classe PendingCall 
import rax.rpc.RelayResponder; // importer la classe RelayResponder 
import mx.rpc.ResultEvent; // importer la classe ResultEvenc 
import mx.rpc.FaultEvent; // importer la classe EaultEvent 

7 // 

8 import mx. reacting. RecordSet; // importer la classe RecordSet 

9 import rax. utils. Iterator; // importer la classe Iterator 

0 // 

1 //Import de la classe NetDebug et initialisation du debogeur NetDebug 

2 import mx.remoting. debug. NetDebug; 

3 mx . remoting. debug. NetDebug. init ialize () ; 




Figure 25-17 

Test de I'application mesAdherents.swf. 
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Comme dans l'exemple precedent, vous devez voir apparaitre 4 evenements dans le panneau 
NetConnection Debugger. Toutefois, si vous observez le quatrieme evenement, vous remarquerez que 
ce n'est pas cette fois-ci une simple chaine de caracteres, mais qu'il s'agit d'un objet complexe 
comprenant tous les enregistrements generes par la requete SQL (voir figure 25-18). 
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Figure 25-18 

Objet RecordSet contenant les differents enregistrements generes par la requete SQL et affiches par 
NetConnection Debugger. 



Variante avec filtre parametrable 

Le systeme que nous venons de presenter permet de recuperer facilement les resultats d'un jeu 
d'enregistrements sous Flash. Toutefois, la requete SQL est fixe et ne peut etre modifiee par le client 
Flash. Nous vous proposons maintenant une variante de cette application qui permet de passer une 
lettre en parametre depuis Flash afin que la liste renvoyee corresponde uniquement aux adherents 
dont le nom commence par cette lettre. 
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Modification du fichier Flash 

Commencez par enregistrer le fichier mesAdherents.fi a sous le nom mesAdherentsSelectif.fi a. A la 
ligne 20, changez le troisieme parametre (ce parametre indique le nom de la classe ciblee) en le 
renommant baseSportSelective (voir figure 25-19 repere 1). 

maConnexion = new Service(urlPasserelle, null ."baseSportSelective") ; 
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.reacting. RecordSec; // importer la classe RecordSet 
I ax. ut lis. Iterator; // importer la classe Iterator 
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| nx . remot 1 ng . debug . He t Debug; 
ting. debug. Net Debug. initialize () ; 



vec la classe PHP baseSport 

I I I II I III I J ll| I I iMjjl I I ^ 

1 Passer e lie, nul ^"baseSport Selective" 
1 isteAdherents 




11 - maConnexit ^Tist eAdherentsSelectlve (| 
-Cestion du resuUat^VTfniiMviv^v^l 

-des met ho de a de traitement des resultats et des 
|ur.responder • nev RelayResponder (ecouteur, "traitementResultat", ' 

naire du resultat envoye par AHFPHP 
|r.traitementResultat • runetion(resultat:ResultEvent) rVoid 

du pointeur de l'lterateur 
pointeur: Iterator - resultat. result. getlterator () ; 

Boucle sur les enreglstrements du resultat 
I le ( pointeur . hasHex t ( ) ) 



erreurs 
traitementEr: 



jgne 23 de 46, Col 65 
► MttGonrwctfon DsbuQDM 



Figure 25-19 

Modification de mesAdherentsSelectif.fla. 

Puis, a la ligne 22, ajoutez une instruction d' initialisation de la variable (voir la ligne de code ci- 
dessous) qui sera passee a la methode pour servir de critere de filtre dans la requete SQL (voir figure 25- 
19 repere 2). 

var critere:String="C" ; 

Cette variable est actuellement initialisee par defaut avec la lettre C, mais il vous sera tres facile par 
la suite de creer un formulaire afin que l'utilisateur puisse modifier lui-meme cette lettre. 
Enfin, dans Finstmction d'appel de la methode, renommez la methode avec 1 isteAdherentsSelective( ) , 
puis ajoutez le parametre critere precedemment defini entre les deux parentheses (voir figure 25-19 
repere 3). 

var monRetounPendingCall = maConnexion. listeAdherentsSelective(critere); 
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Modification de la classe PHP 

Cote PHP, nous allons devoir creer une autre classe en enregistrant la classe actuelle baseSport.php 
sous le nom baseSportSelective.php. Ouvrez ensuite ce nouveau flchier dans Dreamweaver, et modi- 
flez le nom de la classe dans la methodTable et dans la declaration de la classe elle-meme (voir 
figure 25-20 repere 1). Ajoutez ensuite une propriete supplementaire arguments a cette methode dans 
la methodTable en precisant le nom de Fargument attendu par la methode critere (voir figure 25-20 
repere 2). Ajoutez ce nouvel argument cri tere entre les parentheses de la methode (voir figure 25-20 
repere 3) puis modifiez la requete SQL de facon a integrer la valeur de critere dans la clause WHERE 
(voir figure 25-20 repere 4) comme indique dans la requete SQL ci-dessous. 

SELECT id.nom.prenom.anneeNaissance FROM adherents WHERE nom LIKE "'.$critere."%' 

Enregistrez ensuite votre fichier et testez le dans le Web Local pour vous assurer qu'il ne contient pas 
d'erreur. 
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Figure 25-20 

Modification de la classe baseSportSelective.php. 
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Test de la nouvelle application 

Revenez dans le logiciel Flash pour tester Fapplication (Ctrl+Entree). La fenetre de l'application 
mesAdherentsSelectif .swf doit apparaitre, ainsi que le panneau de sortie, dans lequel doit figurer le 
resultat renvoye par le serveur (voir figure 25-21). Contrairement au test de la version precedente, le 
jeu d'enregistrements ne doit comporter maintenant que les adherents don le nom commence par 
unC. 
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Figure 25-21 

Test de l'application mesAdherentsSelectif. swf. 
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Mamp, une infrastructure serveur pour Mac 

Depuis les systemes X, les machines Apple sont des ordinateurs Unix BSD qui integrent un serveur 
Web Apache et le preprocesseur PHP par defaut. Le serveur Apache et les modules PHP sont preins- 
talles, mais ne sont pas actives par defaut. Par contre, la base de donnees MySQL et son gestionnaire 
phpMy Admin ne sont pas preinstalles sur les Macintosh. 

II est done necessaire de configurer votre ordinateur Macintosh afin de disposer d'une infrastructure 
serveur locale et de pouvoir developper et tester des sites dynamiques en local. 

Pour cela, vous disposez de deux alternatives. 

1 . Activer le serveur Apache et PHP puis installer les applications manuellement. 

2. Installer automatiquement une suite de logiciel Mamp : Macintoch, Apache, MySQL, PHP 
(semblable aWamp 5 pour Windows). 

La seconde solution etant beaucoup plus simple et rapide a mettre en place, nous vous proposons ci- 
apres de vous guider pas a pas dans son installation. 

Nous vous proposerons ensuite de detailler les differentes procedures pour creer une base de 
donnees, mettre en place des scripts a la racine du serveur local, configurer un site dans Dreamweaver 
et enfin visualiser et tester vos pages dynamiques depuis un navigateur. Meme si certains parametres 
sont differents (numero de port, etc), sachez que toutes les pages dynamiques presentees dans cet 
ouvrage pour l'environnement Windows pourront etre realisees de la meme maniere avec votre 
Macintosh. 
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Installation de Mamp 

Avant toute chose, vous devez commencer par telecharger le dernier package Mamp sur le site de son 
editeur webEdition Software (voir figure A-l, http://www.mamp.info/fr/home/). Pour votre informa- 
tion, sachez que pour cette demonstration, nous avons utilise la version Mamp 1.1.1, mais la demar- 
che sera semblable si vous utilisez une version plus recente. 
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devoir changer un seul Scrner de configuration! 

Oe plus, si vous n'avez plus besom de MAMP, d suf fit de supprimer le repertoire 
MAMP et tout retourne dans son etat original (par exempte MAMP ne modVie nen de 
Cnsuilauon "normale" (TOS X). 
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Figure A-1 

Saisissezl 'adresse de V editeur de Mamp (http://www.mamp.info/fi-/liome/) dans votre navigateur puis diquezsur le bouton 
Telecharger. Une seconde page vous invitera a saisir votre e-mail avant de pouvoir acceder a I'espace de telechargement. 



Telechargez le package sur votre ordinateur dans le dossier de votre choix puis cliquez sur le package 
pour l'ouvrir (voir figure A-2). Une fenetre dans laquelle vous trouverez la procedure pour installer 
Mamp doit ensuite apparaitre. Ouvrez une fenetre Finder et cliquez sur la categorie Applications 
(voir figure A-3) puis glisser le dossier Mamp dans votre repertoire Applications. La suite Mamp est 
maintenant installee sur votre ordinateur. 
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Unefois le 
telechargement 
termini, ciiquez sur 
le package pour 
Vouvrir. Unfenetre 
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mettre en place votre 
logiciel sur votre 
ordinateur. 



Figure A-3 

Apres avoir ouvert 
le repertoire 
Applications dans 
une fenetre Finder, 
vous devez y copier 
le dossier complet 
de Mamp sans creer 
d' autre sous- 
repertoire. 





(JjMAMP 

Copy *• ****** tWl* •» Apptcatm to*** on 
><w nard drv* n ontar to raM fcUMP do not 

wrti i-ht infi ii i ri irirnr*ii» 

nil i r ■ i ii rmiMfc i iiiii t iii i i wh 111 

MbMMliMiUWnnriUMVMaiM 



736 



Annexes 



Utilisation de Mamp 

Une fois la suite Mamp installee sur votre ordinateur, nous vous suggerons de creer sur votre bureau 
un alias du fichier application situe dans le dossier Mamp (voir figure A-4). Cliquez ensuite sur cet alias 
pour demarrer 1' application. Une nouvelle fenetre doit alors apparaitre (voir figure A-4) dans laquelle 



MAMP Serv«urs Aide 
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Figure A-4 

Pour faciliter lesfuturs demurrages de Mamp, nous vous conseillons de creer un alias du fichier application sur votre 
bureau. 

les deux voyants representants les serveurs Apache et MySQL doivent progressivement passer au 
vert. Dans cette meme fenetre vous pourrez configurer les differentes options de Mamp en cliquant 
sur le bouton Preferences (voir figure A-5), cependant nous vous conseillons de garder les parame- 
trages par defaut dans un premier temps. Notez que, pour reduire cette fenetre, vous devrez cliquer 
sur le bouton orange situe en haut et a gauche de la fenetre et non cliquer sur le bouton Quitter qui 
aura pour incidence de fermer toutes les applications Mamp et du meme coup les serveurs Apache et 
MySQL. Le bouton Ouvri r la page d ' accuei 1 vous permettra d'acceder a une page Web regroupant 
les differentes applications de la suite Mamp. La premiere page Start vous informe des parametres a 
utiliser pour acceder au serveur MySQL (voir figure A-6). La seconde page phpinfo est tres interes- 
sante car elle affiche toutes les informations correspondantes a la configuration actuelle de PHP (voir 
figure A-7). La page phpMyAdmin permet d'acceder au gestionnaire de la base de donnees MySQL 
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(voir figure A-8) de meme que vous pourrez aussi acceder au gestionnaire du systeme de donnees 
integre a PHP SQLite (ce gestionnaire n'est pas utilise dans le cadre de cet ouvrage). Enfin la 
derniere page FAQ vous permet de connaitre les differentes versions des applications de la suite Mamp 
et repond aux questions frequemment posees. 



Figure A-5 

Le bouton Preferences permet 
d' acceder aux differentes 
options de Mamp. 
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Figure A-6 

La page Start vous informe des parametres MySQL a utiliser dans vos scripts PHP. 
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Figure A-7 

La page phpinfo vous informe de la configuration actuelle PHP. 



Creation d une base de donnees 

Pour vous initier a l'usage de la suite Mamp, nous vous suggerons maintenant de vous rappeler la 
procedure pour creer puis importer une base donnees dans le serveur MySQL local. Pour cela nous 
utiliserons les fichiers SQL inclus dans le kit des codes de cet ouvrage disponibles sur le site de Fedieur 
(voir l'annexe B pour plus d'information sur la localisation de ce kit, www. edit ions-eyrol les .com). 

Apres avoir telecharge sur votre ordinateur le kit des codes de ce livre et avoir localise les fichiers 
SQL que nous allons utiliser (les fichiers SQL se trouvent dans le dossier archives du site SITEsport), 
cliquez sur le bouton phpmyadmi n (voir figure A-8) pour acceder au gestionnaire de la base de donnees. 
Saisissez le nom de la base a creer, soit sport_db pour notre exemple, puis cliquez sur le bouton Creer. 

La base de donnees est maintenant creee mais elle est encore vide. Cliquez sur Fonglet Importer de 
phpMy Admin puis sur le bouton Parcourir afin de localiser le fichier SQL a utiliser (prendre le 
fichier SQL situe dans le repertoire archives du site SITEsport). Apres avoir selectionne le fichier 
SQL, validez votre choix en cliquant sur le bouton Executer situe en bas de la page Importer (voir 
figure A-9). Si vous cliquez ensuite sur le lien portant le nom de la base de donnees (sport_db) situe 
en haut de la page, vous devriez voir les differentes tables apparaitre dans la page (voir figure A- 10). 
Votre base de donnees est maintenant operationnelle, vous pouvez commencer a creer vos pages 
dynamiques afin d'en exploiter ses informations. 
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Figure A-8 

Creation de la base 
de donnees sport-db. 
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Figure A-9 

Importation des tables d'unfichier a" archive SQL. 
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Figure A-10 

Liste des differentes tables importees avec lefichier d 'archive SQL. 



Emplacement du repertoire racine 

Comme vous disposez maintenant des codes des sites disponibles dans le kit de ressource sur votre 
ordinateur, nous vous proposons de vous guider dans leur mise en place a la racine du serveur 
local. 

Ouvrez une fenetre Fi nder et placez-vous a Femplacement du repertoire racine du serveur local (voir 
figure A-ll) : Systeme:Applications:MAMP:htdocs 

Par la suite nous vous conseillons de creer un alias du repertoire racine afin de pouvoir acceder 
rapidement a son contenu. Dans notre exemple, nous avons cree un alias www place sur le 
bureau. 

Faites ensuite glisser le dossier du site SITEsport dans ce repertoire (voir figure A-ll). 
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Figure A-11 

Copiez le dossier du site sport dans le repertoire racine du serveur local. 




Figure A-12 

As surez-vous que le dossier SITEsport comporte les differents repertoires indispensable s 
au fonctionnement du site. 
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Configuration d un site dans Dreamweaver 

Nous allons maintenant ouvrir Dreamweaver et detailler la procedure de configuration d'un site 
dynamique sur votre Macintosh. Depuis le menu de Dreamweaver, cliquez sur Si te puis selectionnez 
Nouveau site.... Assurez-vous que la fenetre de definition des sites est affichee en mode Avance (voir 
figure A- 13). Cliquez sur la categorie Infos 1 ocal es puis saisissez le nom du nouveau site soit SITEs- 
port. A droite du champ Dossi er raci ne local, cliquez sur le petit repertoire afin de localiser Fempla- 
cement des pages dynamiques du site (voir figure A-13). Selectionnez le dossier SITEsport prece- 
demment cree situe dans le repertoire racine du serveur puis cliquez sur le bouton Choi si r. Le chemin 
menant a ce dossier doit ensuite etre copie automatiquement dans le champ conceme. 

Cliquez ensuite sur la categorie Serveur d' evaluation. Selectionnez le modele de serveur PHP 
MySQL puis l'acces Local /Reseau. Assurez-vous que le chemin menant au dossier du site SITEsport 
est correctement configure (voir figure A-14). Dans le champ intitule Prefixe d'URL completez le 
chemin afin qu'il corresponde a l'URL suivante : http: / /local host : 8888/ SITEsport/ 

Validez enfin votre configuration en cliquant sur le bouton OK situe en bas de la fenetre de definition 
du site. 
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Figure A-13 

Configuration de la categorie Infos locales. 
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Figure A-14 

Configuration de la categorie Serveur a" evaluation. 



Les differents fichiers du site sport doivent maintenant apparaitrent dans le panneau Fichiers de 
Dreamweaver. Ouvrez la page adherentsGestion.php situee dans le repertoire sport. Affichez le 
panneau Application et cliquez sur Fonglet Base de donnees. Cliquez sur la connexion existante 
Connexi onSport. Si la connexion n'existe pas encore, vous pouvez la creer en cliquant sur le bouton + 
puis selectionnez connexion MySQL (attention de bien respecter le nom et la casse de la connexion 
si vous desirez par la suite utiliser dans votre site d'autres fichiers du kit). Assurez-vous que les para- 
metres de connexion correspondent bien a ceux de la figure A-15. Notez que dans notre exemple, 
nous utilisons le compte utilisateur par defaut root ; cependant, si vous avez deja cree un compte 
utilisateur sport comme indique dans le chapitre 2, il est plus judicieux d'utiliser ce compte plutot 
que l'utilisateur par defaut root qui doit etre exclusivement utilise pour des tests en local (attention, 
le mot de passe est aussi root pour Mamp, alors que pour la suite Wamp 5, il n'y a pas de mot de 
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passe pour utiliser ce compte root). Cliquez ensuite sur le bouton Tester pour vous assurer de la 
bonne configuration de votre connexion MySQL puis cliquez sur le bouton OK pour confirmer votre 
choix. 

Votre environnement de developpement doit etre maintenant operationnel. Afin de tester le bon fonc- 
tionnement d'une page dynamique, nous vous proposons de consulter la page adherentsGesti on . php 
en suivant la procedure indiquee ci-apres. 
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Figure A-15 

Configuration de la connexion Mysql. 



Consultation du site local depuis un navigateur 

Pour consulter vos pages dynamiques, il ne vous reste plus qu'a ouvrir le navigateur de votre choix. 
Nous vous conseillons de memoriser les URL de la racine du serveur local et de phpMy Admin dans 
les favoris de votre navigateur afin d'y acceder rapidement. 

Le chemin d'acces a la racine du serveur local de Mamp est le suivant (voir figure A-16) : http: // 
localhost:8888/ 

Le chemin d'acces a la page Start (et done a phpMy Admin par le biais du menu) est le suivant : 
http: //local host :8888/MAMP/ 

A la racine du serveur, vous devriez voir apparaitre le dossier copie precedemment (SITEsport). 
Cliquez sur ce dossier afin d' acceder au site dans lequel vous desirez consulter votre premiere page 
dynamique. Cliquez ensuite sur le second lien des deux versions proposees puis sur la page adhe- 
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rentsGesti on . php. Vous devriez alors voir votre premiere page dynamique apparaitre dans le naviga- 
teur (voir figure A- 17). 
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Figure A-16 

Consultation de la racine du serveur local depuis un navigateur. 



PAGE DE GESTION DE LA TABLE adherents 



ajOMt d'gp nflical adherent 



Nom Prtnom Sup. Modlf. 


Bertaut 


Genevieve 


s 


8 


Chapelier 


Roland 


x 


8 


Chauvier 


Christian 


X 


8 


Def ranee 


Jean-Marie 


x 


8 


Dumoulin 


Alice 


x 


8 


Hamond 


Laurence 


X 


x 



Figure A-17 

Consultation de la page adherents Gestion.php depuis un navigateur. 
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Ressources de I'ouvrage 

Les codes sources de cet ouvrage sont disponibles sur le site d'accompagnement de l'editeur 
www. edit i ons-eyrol 1 es . com. 

Lorsque vous arrivez sur la page d'accueil du site, saisissez des mots-cles du titre ou de l'auteur du 
livre dans la zone de recherche (Flash et dynamique par exemple ou encore Def ranee) puis validez. 
Dans la page des resultats, vous trouverez le titre de cet ouvrage, sur lequel il convient de cliquer pour 
acceder a sa fiche et a ses ressources disponibles en telechargement (voir figure B-l). 



Ressources Internet 

Site sur Wamp 5 

www.wampserver.com : il s'agit d'un site sur lequel vous pouvez telecharger la derniere version de 
Wamp 5. Vous y trouverez aussi de nombreux conseils pour bien utiliser Wamp et un forum qui vous 
permettra de communiquer avec d'autres utilisateurs (voir figure B-2). 



Site sur Flash 

www.adobe.fr : il s'agit du site officiel de Macromedia. Vous y trouverez de nombreuses ressources 
autour de Flash 8 et vous pourrez aussi y telecharger rapidement une version d'essai de Flash 8 si 
vous n'en disposez pas encore. 
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1 3 PHP/MySQL avec Flash MX 2004 Editions Eyrolles Microsoft Internet Explorer 
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• Aux debutants en programmation ActionScript et PHP souhaitant realiser des sites 
dynamiques en Flash 

• Aux graphistes et developpeurs connaissant deja la programmation ActionScript 
desirant coupler leurs animations Flash a une base de donnees 

• Aux programmers connaissant deia PHP et souhaitant mteqrer leurs applications 
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Figure B-1 

Site www.editions-eyrolles.com pour acceder aux codes sources de cet ouvrage, cliquez sur le fichier des codes sources 
dans la rubrique Tele 'char "gements, 



Sites sur Flash 8 et PHP 

www.fi ash-db.com : ce site en anglais propose de nombreux scripts utilisant Flash 8 et le couple PHP- 
MySQL ainsi que plusieurs tutoriaux sur le meme sujet. 

web . devel oppez . com : developpez.com est un site incontournable pour les developpeurs. De nombreux 
onglets permettent d' acceder a des sous-domaines dedies a differentes technologies telles que PHP, 
SQL, XML ou encore au developpement Web (dont Flash). Dans chaque sous-domaine vous retrouverez 
un forum, FAQ, tutoriel et des critiques d'ouvrage sur le sujet. 

www. your-socket . com : ce site est dedie aux applications client-serveur telles que Flash-PHPsocket. II 
propose des formules d'hebergement vous permettant d'utiliser les ports de communication pour 
realiser des « chat » ou des jeux multi-utilisateurs. Le serveur de socket en PHP utilise a la fin du 
chapitre 22 est issu de ce site. 
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3 PHP5 Apache MySQL sur Windows : WAMP5 Microsoft Internet Explorer 
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Figure B-2 

Site www.wampserver.com pour telecharger la suite Wamp 5 du serveur local utilise dans cet ouvrage. 



www.flash-france.com : ce site en francais comporte de nombreuses rubriques consacrees a Flash 
(forum, tutoriaux, news, astuces, interview, . . .). Une rubrique « Film.fla » pemiet aussi de telecharger 
une selection de fragments de code ActionScript. 

www.flashxpress.net : ce site en francais comporte de nombreuses rubriques consacrees a Flash et 
PHP. Vous y trouverez aussi des tutoriaux interessants sur l'usage d' AMFPHP et de Flash Remoting. 

www.kirupa.com : ce site en anglais presente de nombreux tutoriaux ainsi que des forums dedies a 
Flash, a PHP et a XML. 

www.media-box.net : ce site en francais presente differents tutoriaux consacres a Flash, a PHP et a 
XML. Vous y decouvrirez aussi des tutoriaux interessants sur AMFPHP qui vous seront tres utiles en 
complement de l'initiation a la technique presentee dans cet ouvrage. 
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www.yazo.net : ce site en francais regroupe de nombreuses ressources Flash et propose d'interessant 
tutoriaux qui vous permettront de vous former rapidement a Flash. 

www.lexplicateur.com : ce site en francais met a votre disposition de nombreux fragments de 
code ActionScript. Un moteur de recherche interne vous permettra de trouver rapidement le code 
desire. 

www.amfphp.org : site officiel d'AMFPHP, vous y trouverez toutes les ressources necessaires a 
F installation des classes AMFPHP sur votre serveur, un forum et de nombreux exemples et tutoriaux 
qui vous permettront d'exploiter rapidement cette technologie dans vos futurs projets... 
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► Introduction 



AMFPHP is an open-source Dash Remobng gateway. It's fast, reliable, 100% 
free and open-source. Flash Remobng is a technology built into the Flash 
player core that enables sending data between the server and the client 
seemlessly. If you've built XML-based RIAs you know how much of a pain it 
can be to serialize the data, debug, and integrate into your application, With 
Flash Remoting, you can call remote methods from the Flash client and the 
arguments will end up m the native remote language, and will come back to 
Flash correctly typed, so there's no messing with serialization at all. 



You also get to use the wonderful NetConnection debugger, which shows you 
exactly what's being sent between the client and server. Remoting uses 
AMF, a very lightweight binary format that cuts the bulk out of packets, 
meaning data exchange is a lot faster than with XML. All in all, Remoting is 
the way to go if you're looking to build robust, fast and secure Rich Internet 
Applications. 



AMFPHP is a complete implementation of Remoting for PHP with tons of 
features built-in to make creabng Remoting apps a whole lot simpler. A 
distinguishing feature of AMFPHP is the built-in service browser, *hich vou 
can test out live here , which makes tesbng asynchronous apps and 
generabng stub code a dick away, you can read more about ntu awfph p 
and Remobng rock . Or read more about the AHfPHP project . 
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figure B-3 

Site www.amfphp.org pour telecharger les classes AMFPHP et trouver de nombreuses ressources concernant son 
utilisation. 



Ressources en ligne 

Site sur PHP 

www.php.net : il s'agit du site officiel de PHP. Vous y trouvez toute la documentation en francais, 
disponible en telechargement sous differents formats (HTML, PDF...). Pour acceder a cette docu- 
mentation, cliquez sur documentation dans le menu du site, puis choisissez la langue et le format 
desires dans la liste qui est proposee. 

Site sur MySQL 

www.mysql .com : il s'agit du site officiel de MySQL. Vous y trouvez de nombreuses versions de 
MySQL pour tous les environnements et une documentation tres complete. 
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